RiseV Docs
How to use the RiseV documentation
This docs area is made for buyers of RiseV scripts. Start with the general Installation page, then pick your script on the left for step-by-step setup, configuration and in-game usage. If something does not work as expected, use the Troubleshooting page as a checklist before opening a ticket.
- Select Home in the sidebar to come back to this overview at any time.
-
Below that, choose your script to open its pages
(for example
index.mdfor overview,config.mdfor settings,exports.mdandevents.mdfor advanced integration). - All content is written in Markdown and rendered here, so every update to the docs is available for you directly on this page.
- For a generic overview on how to install RiseV resources on your FiveM server, use the Installation page. If you run into problems afterwards, the Troubleshooting page guides you through the most common fixes.
For each script you will usually find: what the script does, requirements, a clean installation guide, recommended config values and examples you can copy-paste into your server setup.
Recommended reading order
When you install a script for the first time, go through the pages in this order:
overview (index.md) → script-specific installation/setup →
config.md for options →
exports.md / events.md if you want custom integrations.
If something does not work as expected, first re-check the docs and then the
Troubleshooting page before opening a support ticket.
Getting started
Installing a RiseV script from FiveM cfx portal
This page explains the generic installation flow for all RiseV resources you buy on the FiveM cfx portal. Always read the script-specific docs as well.
1. Ressource im cfx-Portal herunterladen
- Öffne das cfx-Portal in deinem Browser: portal.cfx.re.
- Melde dich mit dem CFX-Account an, mit dem du das RiseV-Script gekauft hast.
- Öffne deine gekauften Assets und wähle das Script, das du installieren möchtest.
- Klicke auf den Download-Button, um die aktuelle Version der Ressource als
.zip-Datei herunterzuladen.
2. ZIP-Datei auf deinem PC entpacken
- Verschiebe die heruntergeladene
.zip-Datei in einen Ordner auf deinem PC (z. B.RiseV_Scripts/). - Klicke die Datei mit Rechtsklick an und wähle „Alle extrahieren…“ (oder die entsprechende Option deines Betriebssystems).
- Im entpackten Ordner findest du den eigentlichen Ressourcenordner
(z. B.
risev_notify,risev_inventoryusw.). - Achte darauf, dass es keine doppelte Verschachtelung gibt wie
resources/risev_notify/risev_notify/. Der Ressourcenordner darf nur eine Ebene tief liegen.
3. Ressource in deinen FiveM-Server kopieren
- Verbinde dich mit deinem Server (FTP, SFTP oder direkt, wenn du lokalen Zugriff hast).
- Öffne das Server-Verzeichnis und darin den Ordner
resources. - Lege optional einen Unterordner wie
[risev]an, um alle RiseV-Scripts zu gruppieren. - Lade den Ressourcenordner (z. B.
risev_notify) inresources/[risev]/hoch.
4. Ressource in der server.cfg eintragen
- Öffne deine
server.cfgin einem Editor. - Füge eine
ensure-Zeile für das Script hinzu, zum Beispiel:ensure risev_notify - Platziere diese Zeile in der Nähe von ähnlichen Ressourcen (z. B. andere UI- oder Framework-Scripts), aber immer nach allen Hard-Dependencies (ESX, MySQL/oxmysql usw.).
- Speichere die Datei und starte den Server neu.
5. Erster Start & Grundchecks
- Starte oder restarte deinen Server und beobachte die Konsole auf Fehlermeldungen zur neuen Ressource.
- Joine auf den Server und öffne die F8-Konsole. Achte auf rote Fehlermeldungen, in denen der Name des RiseV-Scripts vorkommt.
- Wenn das Script ohne Fehler lädt, arbeite die script-spezifische Doku
(meist
index.mdundconfig.md) durch und passe die Config an deinen Server an.
Gute Praxis für Updates
Wenn du im cfx-Portal auf eine neue Version updatest, schreiben wir im Changelog in der
Regel dazu, wenn sich etwas an den Configs geändert hat. Du musst deine Einstellungen
also
nicht komplett neu bauen. Bei größeren Updates ist es trotzdem oft besser, den alten
Ressourcenordner zu löschen und die neue Version sauber hochzuladen. Übernimm deine
bisherigen Config-Werte dann gezielt in die neuen config-Dateien, statt
alles
zu überschreiben. So vermeidest du Probleme durch veraltete Dateien.
1. Download the resource from the cfx portal
- Open the cfx portal in your browser: portal.cfx.re.
- Log in with the CFX account that owns the RiseV script.
- Open your purchased assets and select the script you want to install.
- Click the download button to get the latest version of the resource as a
.ziparchive.
2. Extract the ZIP on your PC
- Move the downloaded
.zipfile into a folder on your PC (for exampleRiseV_Scripts/). - Right-click the file and choose “Extract all…” (or the equivalent option on your OS).
- Inside the extracted folder you will see the actual resource folder
(for example
risev_notify,risev_inventory, etc.). - Make sure there is no double nesting like
resources/risev_notify/risev_notify/– the resource folder should only be one level deep.
3. Place the resource in your FiveM server
- Connect to your server machine (FTP, SFTP or local file system).
- Open your FiveM server data directory and then the
resourcesfolder. - Optionally create a subfolder like
[risev]to keep all RiseV scripts grouped. - Upload the resource folder (for example
risev_notify) intoresources/[risev]/.
4. Add the resource to your server.cfg
- Open your
server.cfgin a text editor. - Add an
ensureline for the script, for example:ensure risev_notify - Place this line close to similar resources (for example other UI or framework scripts), but always after all hard requirements (ESX, MySQL/oxmysql, etc.).
- Save the file and restart the server.
5. First start & basic checks
- Start or restart your server and watch the console for errors related to the new resource.
- Join the server and open your F8 console. Look for red errors that mention the RiseV script name.
- If the script loads without errors, follow the script-specific docs
(usually
index.mdandconfig.md) and configure it for your server.
Good practice for updates
When you update to a new version from the cfx portal we usually mention config changes
in
the changelog. You normally don’t have to rebuild your whole config, but for some
updates it
is still safer to delete the old resource folder first and upload the new one cleanly.
Then
copy your previous settings into the new config files instead of
overwriting
everything. This prevents issues caused by outdated files.
1. Télécharger la ressource depuis le portail cfx
- Ouvre le portail cfx dans ton navigateur : portal.cfx.re.
- Connecte-toi avec le compte CFX qui possède le script RiseV.
- Va dans tes assets achetés et sélectionne le script que tu veux installer.
- Cliqe sur le bouton de téléchargement pour récupérer la dernière version de la ressource au
format
.zip.
2. Extraire le ZIP sur ton PC
- Déplace le fichier
.ziptéléchargé dans un dossier de ton PC (par exempleRiseV_Scripts/). - Fais un clic droit sur le fichier et choisis « Extraire tout… » (ou l’option équivalente de ton système).
- Dans le dossier extrait tu trouveras le vrai dossier de ressource
(par exemple
risev_notify,risev_inventory, etc.). - Vérifie qu’il n’y a pas de double niveau comme
resources/risev_notify/risev_notify/: le dossier de ressource ne doit avoir qu’un seul niveau.
3. Copier la ressource sur ton serveur FiveM
- Connecte-toi à ta machine serveur (FTP, SFTP ou accès local).
- Ouvre le répertoire de données de ton serveur FiveM puis le dossier
resources. - Crée éventuellement un sous-dossier comme
[risev]pour regrouper tous les scripts RiseV. - Téléverse le dossier de ressource (par exemple
risev_notify) dansresources/[risev]/.
4. Ajouter la ressource dans server.cfg
- Ouvre ton fichier
server.cfgdans un éditeur de texte. - Ajoute une ligne
ensurepour le script, par exemple :ensure risev_notify - Place cette ligne près des ressources similaires (autres UIs, scripts framework), mais toujours après toutes les dépendances principales (ESX, MySQL/oxmysql, etc.).
- Enregistre le fichier et redémarre le serveur.
5. Premier démarrage & vérifications de base
- Démarre ou redémarre ton serveur et surveille la console pour voir s’il y a des erreurs liées à la nouvelle ressource.
- Rejoins le serveur et ouvre la console F8. Regarde s’il y a des erreurs en rouge mentionnant le script RiseV.
- Si le script se charge sans erreur, suis la documentation spécifique au script
(généralement
index.mdetconfig.md) et configure-le pour ton serveur.
Bonne pratique pour les mises à jour
Quand tu mets à jour vers une nouvelle version depuis le portail cfx, nous indiquons en
général les changements de configuration dans le changelog. Tu n’as donc pas besoin de
recréer toute ta config, mais pour certaines mises à jour il reste plus sûr de supprimer
l’ancien dossier de ressource et de téléverser proprement la nouvelle version. Copie
ensuite
tes anciens réglages dans les nouveaux fichiers config au lieu d’écraser
tout
le dossier. Cela évite les bugs liés à des fichiers obsolètes.
1. Descargar la ressource desde el portal cfx
- Abre el portal cfx en tu navegador: portal.cfx.re.
- Inicia sesión con la cuenta de CFX con la que compraste el script de RiseV.
- Ve a tus assets comprados y selecciona el script que quieres instalar.
- Haz clic en el botón de descarga para obtener la última versión de la ressource en un
archivo
.zip.
2. Extraer el ZIP en tu PC
- Mueve el archivo
.zipdescargado a una carpeta de tu PC (por ejemploRiseV_Scripts/). - Haz clic derecho sobre el archivo y elige “Extraer todo…” (o la opción equivalente en tu sistema).
- Dentro de la carpeta extraída verás la carpeta de la ressource
(por ejemplo
risev_notify,risev_inventory, etc.). - Asegúrate de que no haya doble carpeta, como
resources/risev_notify/risev_notify/. La carpeta de la ressource debe tener solo un nivel.
3. Colocar la ressource en tu servidor FiveM
- Conéctate a tu servidor (FTP, SFTP o sistema de archivos local).
- Abre el directorio de datos de tu servidor FiveM y luego la carpeta
resources. - Opcionalmente crea una subcarpeta como
[risev]para agrupar todos los scripts de RiseV. - Sube la carpeta de la ressource (por ejemplo
risev_notify) dentro deresources/[risev]/.
4. Añadir la ressource a tu server.cfg
- Abre tu archivo
server.cfgen un editor de texto. - Añade una línea
ensurepara el script, por ejemplo:ensure risev_notify - Coloca esta línea cerca de otras ressource similares (por ejemplo otras UIs o scripts de framework), pero siempre después de todas las dependencias importantes (ESX, MySQL/oxmysql, etc.).
- Guarda el archivo y reinicia el servidor.
5. Primer inicio y comprobaciones básicas
- Inicia o reinicia tu servidor y revisa la consola por si hay errores relacionados con la nueva ressource.
- Entra al servidor y abre la consola F8. Busca errores en rojo donde aparezca el nombre del script de RiseV.
- Si el script se carga sin errores, sigue la documentación específica del script
(normalmente
index.mdyconfig.md) y ajústalo para tu servidor.
Buena práctica para actualizaciones
Cuando actualices a una nueva versión desde el portal cfx, normalmente indicamos los
cambios
de configuración en el changelog. Normalmente no tienes que rehacer toda la config, pero
en
algunas actualizaciones es más seguro borrar primero la carpeta antigua de la ressource
y
subir la nueva versión limpia. Después copia tus ajustes antiguos a los nuevos archivos
config en lugar de sobrescribir todo el directorio. Así evitas problemas
por
archivos antiguos.
1. Transferir o recurso a partir do portal cfx
- Abre o portal cfx no teu navegador: portal.cfx.re.
- Inicia sessão com a conta CFX com que compraste o script RiseV.
- Abre a lista de assets comprados e seleciona o script que queres instalar.
- Clica no botão de download para obter a versão mais recente do recurso em ficheiro
.zip.
2. Extrair o ZIP no teu PC
- Move o ficheiro
.zipdescarregado para uma pasta no teu PC (por exemploRiseV_Scripts/). - Clica com o botão direito e escolhe “Extrair tudo…” (ou a opção equivalente no teu sistema).
- Dentro da pasta extraída vais encontrar a pasta real do recurso
(por exemplo
risev_notify,risev_inventory, etc.). - Garante que não há uma pasta dupla como
resources/risev_notify/risev_notify/. A pasta do recurso deve ter apenas um nível.
3. Colocar o recurso no teu servidor FiveM
- Liga-te à máquina do servidor (FTP, SFTP ou acesso local ao sistema de ficheiros).
- Abre o diretório de dados do servidor FiveM e depois a pasta
resources. - Opcionalmente cria uma subpasta como
[risev]para agrupar todos os scripts RiseV. - Carrega a pasta do recurso (por exemplo
risev_notify) pararesources/[risev]/.
4. Adicionar o recurso ao server.cfg
- Abre o ficheiro
server.cfgnum editor de texto. - Adiciona uma linha
ensurepara o script, por exemplo:ensure risev_notify - Coloca esta linha perto de recursos semelhantes (outras UIs, scripts de framework), mas sempre depois de todas as dependências críticas (ESX, MySQL/oxmysql, etc.).
- Guarda o ficheiro e reinicia o servidor.
5. Primeiro arranque e verificações básicas
- Inicia ou reinicia o servidor e verifica a consola para ver se há erros ligados ao novo recurso.
- Entra no servidor e abre a consola F8. Procura erros a vermelho que mencionem o script RiseV.
- Se o script arrancar sem erros, segue a documentação específica do script
(normalmente
index.mdeconfig.md) e ajusta-o ao teu servidor.
Boa prática para atualizações
Quando atualizas para uma nova versão a partir do portal cfx nós normalmente indicamos
as
alterações de configuração no changelog. Regra geral não precisas de refazer toda a
config,
mas em algumas atualizações é mais seguro apagar primeiro a pasta antiga do recurso e
enviar a nova versão de forma limpa. Depois copia as tuas definições antigas para os
novos
ficheiros config em vez de substituir a pasta completa. Assim evitas
problemas
causados por ficheiros antigos.
1. تنزيل المورد من بوابة cfx
- افتح بوابة cfx في المتصفح لديك: portal.cfx.re.
- سجّل الدخول بحساب CFX الذي اشتريت به سكربت RiseV.
- اذهب إلى قائمة الأصول التي اشتريتها واختر السكربت الذي تريد تثبيته.
- اضغط على زر التحميل للحصول على أحدث نسخة من المورد على شكل ملف
.zip.
2. فك ضغط ملف ZIP على جهازك
- انقل ملف
.zipالذي قمت بتحميله إلى مجلد على جهازك (مثلًاRiseV_Scripts/). - اضغط بزر الفأرة الأيمن على الملف واختر “استخراج الكل…” أو الخيار المشابه في نظامك.
- داخل المجلد بعد فك الضغط ستجد مجلد المورد نفسه
(مثل
risev_notifyأوrisev_inventoryوغيرهما). - تأكّد من عدم وجود تعشيق مزدوج مثل
resources/risev_notify/risev_notify/، يجب أن يكون مجلد المورد في مستوى واحد فقط.
3. وضع المورد داخل خادم FiveM
- اتصل بجهاز الخادم (عن طريق FTP أو SFTP أو مباشرة إن كان الخادم محليًا).
- افتح مجلد بيانات خادم FiveM ثم مجلد
resources. - يمكنك إنشاء مجلد فرعي مثل
[risev]لتجميع جميع سكربتات RiseV فيه. - قم برفع مجلد المورد (مثل
risev_notify) إلىresources/[risev]/.
4. إضافة المورد إلى ملف server.cfg
- افتح ملف
server.cfgفي محرّر نصوص. - أضف سطر
ensureللمورد، مثلًا:ensure risev_notify - ضع هذا السطر بجانب الموارد المشابهة (مثل سكربتات الواجهة أو الـ framework)، ولكن دائمًا بعد كل المتطلبات الأساسية (ESX، و MySQL/oxmysql وغيرهما).
- احفظ الملف ثم أعد تشغيل الخادم.
5. أول تشغيل وفحوصات أساسية
- ابدأ أو أعد تشغيل الخادم وراقب الكونسول لمعرفة إن ظهرت أخطاء مرتبطة بالمورد الجديد.
- ادخل إلى الخادم وافتح كونسول F8. ابحث عن رسائل خطأ حمراء يظهر فيها اسم سكربت RiseV.
- إذا تم تحميل السكربت بدون أخطاء، اتبع مستندات السكربت الخاصة
(غالبًا
index.mdوconfig.md) واضبط الإعدادات بما يناسب خادمك.
أفضل أسلوب للتعامل مع التحديثات
عند التحديث إلى نسخة جديدة من خلال بوابة cfx نوضح عادةً تغييرات الإعدادات في سجل
التغييرات (Changelog). في العادة لن تحتاج إلى بناء الإعدادات من الصفر، لكن في بعض
التحديثات يكون من الأفضل حذف مجلد المورد القديم ورفع النسخة الجديدة بشكل نظيف. بعد ذلك
انسخ إعداداتك القديمة إلى ملفات config الجديدة بدل استبدال المجلد بالكامل،
وهذا يقلّل من المشاكل الناتجة عن الملفات القديمة.
Support & troubleshooting
Troubleshooting checklist for RiseV scripts
If something does not work as expected, follow this step-by-step checklist before opening a support ticket. This helps to rule out common issues and makes support faster and easier.
1. Backup deines aktuellen Setups
- Gehe auf deinem Server in den Ordner
resourcesund suche das betroffene RiseV-Script. - Lade den kompletten Ressourcenordner auf deinen PC herunter
(inklusive
config.luaund allen Dateien, die du angepasst hast). - Benenne den Backup-Ordner lokal z. B. in
risev_notify_backup_YYYY-MM-DDum, damit du ihn später wiederfindest.
2. Script vom laufenden Server entfernen
- Stoppe das Script in der Serverkonsole mit
stop <resourceName>(z. B.stop risev_notify). - Lösche den Ressourcenordner im
resources-Verzeichnis (oder verschiebe ihn außerhalb vonresources). - Entferne oder kommentiere die
ensure-Zeile in derserver.cfg, die das Script startet.
3. Neueste Version aus dem cfx-Portal laden
- Öffne portal.cfx.re und melde dich mit dem Account an, der das Script besitzt.
- Gehe zu deinen gekauften Assets und lade die aktuellste Version des Scripts herunter.
- Entpacke das
.zipauf deinem PC und lade den frischen Ressourcenordner wieder in deinenresources-Ordner (am besten in einen Ordner wie[risev]). - Füge
ensure <resourceName>erneut in dieserver.cfgein und starte den Server neu.
4. Mit Standard-Config testen
- Starte das Script zunächst mit der Standard-Config, die mit RiseV ausgeliefert wird – noch ohne deine alten Einstellungen.
- Starte den Server neu und joine mit einem Testaccount.
- Prüfe, ob die Grundfunktionen laufen (UI öffnet sich, Befehle funktionieren, keine Fehler in Server-/F8-Konsole).
- Wenn mit Standard-Config alles funktioniert, liegt das Problem meist an deiner Config oder an einem anderen Script.
5. Eigene Config Schritt für Schritt übernehmen
- Öffne dein Backup der alten Config und die neue
config.luanebeneinander. - Übernimm deine Einstellungen in Blöcken (z. B. zuerst Framework-Einstellungen, dann UI, dann Logging usw.).
- Starte nach jedem Block den Server neu und teste erneut.
- Wenn das Script nach einer bestimmten Änderung plötzlich nicht mehr funktioniert, hast du die problematische Einstellung gefunden. Setze sie zurück oder passe sie an.
6. Auf Konflikte mit anderen Ressourcen prüfen
- Achte in der Serverkonsole auf Fehler, die andere Ressourcen, doppelte Events/Exports oder fehlende Abhängigkeiten erwähnen.
- Stelle sicher, dass du ein unterstütztes Framework und passende Versionen nutzt (z. B. ESX Legacy, oxmysql usw.).
- Deaktiviere testweise andere Scripts, die ähnliche Systeme anfassen (z. B. andere HUDs oder Inventarsysteme), und teste noch einmal.
7. RiseV-Support kontaktieren
Wenn der Fehler nach einer sauberen Neuinstallation mit aktueller Version und Standard-Config immer noch besteht, ist es Zeit für ein Support-Ticket.
- Joine den RiseV-Discord (Link auf der Hauptseite oder im Footer).
- Bereite folgende Infos vor:
- Welches RiseV-Script und welche Version du verwendest.
- Deine FiveM-Build-Version und dein Betriebssystem.
- Dein Framework (z. B. ESX Legacy) und wichtige Abhängigkeiten (z. B. oxmysql) inklusive Versionen.
- Fehlermeldungen aus Serverkonsole und F8-Konsole (als Text oder Screenshot).
- Kurze, klare Schritte, wie man den Fehler ingame nachstellen kann.
- Erstelle ein Ticket oder folge dem beschriebenen Support-Ablauf und füge diese Infos direkt mit ein, damit wir schneller helfen können.
Warum diese Checkliste wichtig ist
Der Ablauf (Backup → Clean-Install → Standard-Config → Änderungen Schritt für Schritt) sorgt dafür, dass du dein Setup nicht verlierst und trotzdem in einer sauberen Umgebung testen kannst. Viele typische Fehler verschwinden so schon vorher – der Support muss dann nur noch die echten Sonderfälle suchen, was dir schnellere Lösungen bringt.
1. Back up your current setup
- On your server, go to the
resourcesfolder and find the RiseV script that causes issues. - Download the whole resource folder to your PC as a backup
(including
config.luaand any files you changed). - Optionally rename the backup folder locally to something like
risev_notify_backup_YYYY-MM-DDso you can find it later.
2. Remove the script from the running server
- In your server console, run
stop <resourceName>for the script (for examplestop risev_notify). - Delete the resource folder from
resourceson the server (or move it out of that directory). - Remove or comment out the line in
server.cfgthatensures the resource.
3. Download the latest version from the cfx portal
- Open portal.cfx.re and log in with the account that owns the script.
- Go to your purchased assets and download the latest version of the script.
- Extract the
.zipon your PC and upload the fresh resource folder to yourresourcesfolder (ideally into a folder like[risev]). - Add
ensure <resourceName>back toserver.cfgand restart the server.
4. Test with the default configuration
- Before copying your old config, start the script once with the default configuration shipped by RiseV.
- Restart the server and join with a test account.
- Check if the basic functionality works (UI opens, commands run, no errors in server or F8 console).
- If everything works with the default settings, the problem is usually your custom config or another resource on your server.
5. Re-apply your custom config step by step
- Open your backup config and the new
config.luaside by side. - Copy your custom values in small blocks (for example framework settings first, then UI, then logging, etc.).
- After each block, restart the server and test again.
- If the script breaks after a specific change, you have found the problematic setting. Fix it or reset that part to the default value.
6. Check for conflicts with other resources
- Look for errors in your server console that mention other resources, duplicate events/exports or missing dependencies.
- Make sure you use a supported framework and versions (for example ESX Legacy, oxmysql, etc.).
- Temporarily disable other scripts that touch the same systems (for example other HUDs or inventory systems) and test again.
7. Contact RiseV support
If the problem still exists after a clean re-install with the latest version and default config, it’s time to reach out to support.
- Join the RiseV Discord (link on the main website or in the footer).
- Prepare the following information:
- Which RiseV script and which version you are using.
- Your FiveM build and operating system.
- Your framework (for example ESX Legacy) and main dependencies (for example oxmysql) including versions.
- Error messages from server console and F8 console (copy as text or screenshots).
- Short, clear steps to reproduce the issue in game.
- Open a ticket or follow the described support flow and paste this information so we can help efficiently.
Why this checklist matters
Following this flow (backup → clean install → default config → step-by-step changes) makes sure you don’t lose your setup while still testing in a clean environment. It also removes many common issues before support even looks at the case, which means faster solutions for you.
1. Sauvegarder ta configuration actuelle
- Sur ton serveur, va dans le dossier
resourceset trouve le script RiseV qui pose problème. - Télécharge le dossier complet de la ressource sur ton PC comme sauvegarde
(y compris
config.luaet tous les fichiers que tu as modifiés). - Renomme éventuellement ce dossier en local, par exemple
risev_notify_backup_YYYY-MM-DD, pour le retrouver facilement.
2. Retirer le script du serveur en cours d’exécution
- Dans la console du serveur, exécute
stop <resourceName>pour le script (par exemplestop risev_notify). - Supprime le dossier de la ressource dans
resources(ou déplace-le en dehors de ce dossier). - Supprime ou commente la ligne dans
server.cfgquiensurela ressource.
3. Télécharger la dernière version depuis le portail cfx
- Ouvre portal.cfx.re et connecte-toi avec le compte qui possède le script.
- Va dans tes assets achetés et télécharge la dernière version du script.
- Extrait le fichier
.zipsur ton PC et téléverse le dossier de ressource fraîchement extrait dans ton dossierresources(idéalement dans un dossier[risev]). - Ajoute de nouveau
ensure <resourceName>dansserver.cfget redémarre le serveur.
4. Tester avec la configuration par défaut
- Avant de copier ton ancienne config, lance le script une fois avec la configuration par défaut fournie par RiseV.
- Redémarre le serveur et rejoins-le avec un compte de test.
- Vérifie que les fonctions de base marchent (UI qui s’ouvre, commandes qui fonctionnent, pas d’erreurs dans la console serveur ou F8).
- Si tout fonctionne avec la config par défaut, le problème vient généralement de ta config personnalisée ou d’une autre ressource.
5. Réappliquer ta config personnalisée étape par étape
- Ouvre ta config de sauvegarde et le nouveau fichier
config.luacôte à côte. - Recopie tes réglages par petits blocs (par exemple d’abord le framework, puis l’UI, puis les logs, etc.).
- Après chaque bloc, redémarre le serveur et teste à nouveau.
- Si le script casse après un bloc précis, tu as trouvé le réglage problématique. Corrige-le ou remets la valeur par défaut.
6. Vérifier les conflits avec d’autres ressources
- Regarde dans la console serveur s’il y a des erreurs mentionnant d’autres ressources, des events/exports en double ou des dépendances manquantes.
- Assure-toi d’utiliser un framework supporté et des versions compatibles (par exemple ESX Legacy, oxmysql, etc.).
- Désactive temporairement d’autres scripts qui touchent les mêmes systèmes (autres HUDs, inventaires, etc.) et teste à nouveau.
7. Contacter le support RiseV
Si le problème existe toujours après une réinstallation propre avec la dernière version et la config par défaut, il est temps de contacter le support.
- Rejoins le Discord RiseV (lien sur le site principal ou dans le footer).
- Prépare les informations suivantes :
- Quel script RiseV et quelle version tu utilises.
- Ta build FiveM et ton système d’exploitation.
- Ton framework (par exemple ESX Legacy) et les principales dépendances (par exemple oxmysql) avec leurs versions.
- Les messages d’erreur de la console serveur et de la console F8 (texte ou captures).
- Une courte description claire pour reproduire le bug en jeu.
- Ouvre un ticket ou suis le process de support indiqué et colle ces informations pour que l’on puisse t’aider efficacement.
Pourquoi cette checklist est importante
Suivre ce flux (sauvegarde → installation propre → config par défaut → changements progressifs) te permet de garder ton setup tout en testant dans un environnement propre. En plus, beaucoup de problèmes courants disparaissent déjà avant même que le support n’intervienne, ce qui accélère les réponses.
1. Hacer copia de seguridad de tu configuración actual
- En tu servidor, ve a la carpeta
resourcesy localiza el script de RiseV que está dando problemas. - Descarga toda la carpeta de la ressource a tu PC como copia de seguridad
(incluyendo
config.luay cualquier archivo que hayas editado). - Opcionalmente renombra la carpeta de backup en local, por ejemplo
risev_notify_backup_YYYY-MM-DD, para encontrarla fácilmente.
2. Quitar el script del servidor en ejecución
- En la consola del servidor ejecuta
stop <resourceName>para el script (por ejemplostop risev_notify). - Borra la carpeta del recurso de
resources(o muévela fuera de esa carpeta). - Elimina o comenta la línea en
server.cfgque haceensuredel recurso.
3. Descargar la última versión desde el portal cfx
- Abre portal.cfx.re e inicia sesión con la cuenta que posee el script.
- Ve a tus assets comprados y descarga la última versión del script.
- Extrae el archivo
.zipen tu PC y sube la carpeta limpia del recurso a la carpetaresources(idealmente dentro de[risev]). - Añade de nuevo
ensure <resourceName>aserver.cfgy reinicia el servidor.
4. Probar con la configuración por defecto
- Antes de copiar tu antigua config, inicia el script una vez con la configuración por defecto que incluye RiseV.
- Reinicia el servidor y entra con una cuenta de pruebas.
- Comprueba si las funciones básicas funcionan (UI se abre, comandos, sin errores en consola del servidor o F8).
- Si todo funciona con la configuración por defecto, el problema suele estar en tu config personalizada o en otro recurso del servidor.
5. Volver a aplicar tu config personalizada paso a paso
- Abre tu config de copia de seguridad y el nuevo
config.luauno al lado del otro. - Copia tus ajustes en bloques pequeños (por ejemplo primero framework, luego UI, luego logging, etc.).
- Después de cada bloque, reinicia el servidor y prueba de nuevo.
- Si el script deja de funcionar tras un bloque concreto, habrás encontrado el ajuste problemático. Corrígelo o vuelve al valor por defecto.
6. Buscar conflictos con otros recursos
- Mira en la consola del servidor si hay errores que mencionen otros recursos, eventos/exports duplicados o dependencias que falten.
- Asegúrate de que uses un framework soportado y versiones compatibles (por ejemplo ESX Legacy, oxmysql, etc.).
- Desactiva temporalmente otros scripts que toquen los mismos sistemas (otros HUDs, inventarios, etc.) y prueba de nuevo.
7. Contactar con el soporte de RiseV
Si el problema sigue después de una reinstalación limpia con la última versión y la config por defecto, es momento de contactar con el soporte.
- Únete al Discord de RiseV (enlace en la página principal o en el pie de página).
- Prepara la siguiente información:
- Qué script de RiseV usas y qué versión.
- Tu build de FiveM y sistema operativo.
- Qué framework utilizas (por ejemplo ESX Legacy) y las dependencias principales (oxmysql, etc.) con sus versiones.
- Mensajes de error de la consola del servidor y de la consola F8 (texto o capturas).
- Pasos cortos y claros para reproducir el problema ingame.
- Abre un ticket o sigue el flujo de soporte indicado y pega toda esta información para que podamos ayudarte de forma más rápida.
Por qué es importante esta checklist
Seguir este flujo (backup → instalación limpia → config por defecto → cambios paso a paso) te permite no perder tu setup y al mismo tiempo probar en un entorno limpio. Además, muchos problemas típicos se eliminan antes de que el soporte tenga que intervenir, lo que hace que la solución llegue mucho más rápido.
1. Fazer backup da configuração atual
- No servidor, vai até à pasta
resourcese encontra o script RiseV que está a causar problemas. - Faz download de toda a pasta do recurso para o teu PC como backup
(incluindo
config.luae quaisquer ficheiros que tenhas alterado). - Se quiseres, renomeia a pasta de backup em local, por exemplo
risev_notify_backup_YYYY-MM-DD, para a encontrares facilmente mais tarde.
2. Remover o script do servidor em execução
- Na consola do servidor executa
stop <resourceName>para o script (por exemplostop risev_notify). - Apaga a pasta do recurso da pasta
resources(ou move-a para fora desse diretório). - Remove ou comenta a linha em
server.cfgque fazensuredo recurso.
3. Transferir a versão mais recente a partir do portal cfx
- Abre portal.cfx.re e inicia sessão com a conta que possui o script.
- Vai à lista de assets comprados e transfere a versão mais recente do script.
- Extrai o ficheiro
.zipno teu PC e envia a nova pasta do recurso para a pastaresources(idealmente dentro de[risev]). - Adiciona novamente
ensure <resourceName>ao ficheiroserver.cfge reinicia o servidor.
4. Testar com a configuração por defeito
- Antes de copiar a tua configuração antiga, inicia o script uma vez com a configuração por defeito fornecida pelo RiseV.
- Reinicia o servidor e entra com uma conta de teste.
- Verifica se as funções básicas estão a funcionar (UI abre, comandos funcionam, sem erros na consola do servidor ou na consola F8).
- Se tudo funcionar com a configuração por defeito, o problema está normalmente na tua config personalizada ou noutro recurso.
5. Aplicar novamente a tua config personalizada passo a passo
- Abre o backup da tua config e o novo
config.lualado a lado. - Copia as tuas definições por blocos pequenos (por exemplo primeiro framework, depois UI, depois logging, etc.).
- Após cada bloco, reinicia o servidor e testa novamente.
- Se o script deixar de funcionar depois de um bloco específico, encontraste a definição problemática. Corrige-a ou volta ao valor padrão.
6. Verificar conflitos com outros recursos
- Vê na consola do servidor se existem erros que mencionem outros recursos, events/exports duplicados ou dependências em falta.
- Garante que estás a usar um framework suportado e versões compatíveis (por exemplo ESX Legacy, oxmysql, etc.).
- Desativa temporariamente outros scripts que mexem nos mesmos sistemas (outros HUDs, sistemas de inventário, etc.) e volta a testar.
7. Contactar o suporte do RiseV
Se o problema continuar depois de uma reinstalação limpa com a versão mais recente e a configuração por defeito, é altura de contactar o suporte.
- Entra no Discord do RiseV (link na página principal ou no footer).
- Prepara a seguinte informação:
- Qual o script RiseV e qual a versão que estás a usar.
- Qual o build do FiveM e o sistema operativo.
- Qual o framework (por exemplo ESX Legacy) e as principais dependências (por exemplo oxmysql) com as respetivas versões.
- Mensagens de erro da consola do servidor e da consola F8 (texto ou capturas de ecrã).
- Passos curtos e claros para reproduzir o problema dentro do jogo.
- Cria um ticket ou segue o fluxo de suporte descrito e cola essa informação para que possamos ajudar de forma mais rápida.
Porque é que esta checklist é importante
Seguir este fluxo (backup → instalação limpa → configuração por defeito → alterações passo a passo) garante que não perdes o teu setup e ainda assim testas num ambiente limpo. Muitos problemas comuns desaparecem logo aqui, o que permite ao suporte focar-se apenas nos casos mais específicos e dar-te respostas mais rápidas.
1. عمل نسخة احتياطية من الإعدادات الحالية
- على الخادم، انتقل إلى مجلد
resourcesوابحث عن سكربت RiseV الذي يسبب المشكلة. - قم بتحميل مجلد المورد بالكامل إلى جهازك كنسخة احتياطية
(بما في ذلك
config.luaوأي ملفات قمت بتعديلها). - يمكنك إعادة تسمية مجلد النسخة الاحتياطية على جهازك مثلًا إلى
risev_notify_backup_YYYY-MM-DDحتى تستطيع العثور عليه بسهولة لاحقًا.
2. إزالة السكربت من الخادم أثناء التشغيل
- في كونسول الخادم شغّل الأمر
stop <resourceName>للسكربت (مثلًاstop risev_notify). - احذف مجلد المورد من مجلد
resources(أو انقله إلى مكان آخر خارج هذا المجلد). - احذف أو علّق السطر في ملف
server.cfgالذي يحتوي علىensureلهذا المورد.
3. تحميل أحدث إصدار من بوابة cfx
- افتح portal.cfx.re وسجّل الدخول بالحساب الذي يملك السكربت.
- اذهب إلى الأصول (assets) التي اشتريتها وحمّل أحدث إصدار من السكربت.
- فك ضغط ملف
.zipعلى جهازك، ثم ارفع مجلد المورد الجديد إلى مجلدresources(ويُفضّل داخل مجلد[risev]). - أضف من جديد سطر
ensure <resourceName>إلىserver.cfgوأعد تشغيل الخادم.
4. الاختبار باستخدام الإعدادات الافتراضية
- قبل نسخ إعداداتك القديمة، شغّل السكربت مرة واحدة باستخدام إعدادات RiseV الافتراضية فقط.
- أعد تشغيل الخادم وادخل بحساب تجريبي.
- تأكد أن الوظائف الأساسية تعمل (الواجهة تفتح، الأوامر تعمل، ولا توجد أخطاء في كونسول الخادم أو F8).
- إذا عمل السكربت بشكل طبيعي مع الإعدادات الافتراضية، يكون السبب في الغالب إعداداتك المخصصة أو تداخل سكربت آخر.
5. إعادة تطبيق إعداداتك خطوة بخطوة
- افتح نسخة إعدادك الاحتياطية وملف
config.luaالجديد جنبًا إلى جنب. - انسخ إعداداتك على شكل مجموعات صغيرة (مثلًا إعدادات الـ framework أولًا، ثم الـ UI، ثم الـ logging وهكذا).
- بعد كل مجموعة، أعد تشغيل الخادم واختبر مرة أخرى.
- إذا بدأ السكربت يتعطل بعد مجموعة معينة، فغالبًا هذه المجموعة هي سبب المشكلة. عدّل تلك الإعدادات أو أعدها للقيم الافتراضية.
6. التحقق من التعارض مع موارد أخرى
- راقب كونسول الخادم بحثًا عن أخطاء تذكر موارد أخرى، أو events/exports مكررة، أو Dependencies مفقودة.
- تأكد من أنك تستعمل Framework مدعوم وإصدارات مناسبة (مثل ESX Legacy و oxmysql وغيرهما).
- قم بإيقاف سكربتات أخرى تتعامل مع نفس الأنظمة مؤقتًا (مثل HUD آخر أو نظام Inventar آخر) واختبر مجددًا.
7. التواصل مع دعم RiseV
إذا استمرت المشكلة بعد إعادة تثبيت نظيفة بأحدث إصدار ومع الإعدادات الافتراضية، فقد حان وقت التواصل مع الدعم.
- ادخل إلى ديسكورد RiseV (الرابط موجود في الموقع الرئيسي أو أسفل الصفحة).
- حضّر المعلومات التالية:
- أي سكربت من RiseV تستخدمه وأي إصدار.
- إصدار FiveM ونظام التشغيل الذي تعمل به.
- الـ Framework الذي تستخدمه (مثل ESX Legacy) وأهم Dependencies (مثل oxmysql) مع أرقام الإصدارات.
- رسائل الخطأ من كونسول الخادم ومن كونسول F8 (كنص أو لقطات شاشة).
- خطوات قصيرة وواضحة لكيفية تكرار المشكلة داخل اللعبة.
- افتح تذكرة دعم أو اتبع خطوات الدعم المذكورة وضع هذه المعلومات بالكامل حتى نتمكن من مساعدتك بأسرع شكل ممكن.
لماذا هذه القائمة مهمة؟
اتباع هذا التسلسل (نسخة احتياطية → تثبيت نظيف → إعدادات افتراضية → تغييرات تدريجية) يضمن ألا تفقد إعداداتك، وفي نفس الوقت تختبر في بيئة نظيفة. الكثير من المشاكل الشائعة تختفي بهذه الخطوات قبل أن يصل الأمر إلى الدعم، وهذا يعني حلولًا أسرع لك.