Comment installer des ressources et scripts FiveM ?

Les ressources sont les briques de votre serveur FiveM : chaque script, job, véhicule ou carte est une ressource avec sa propre structure. Voici comment les installer correctement.

Structure d'une ressource

Chaque ressource est un dossier contenant au minimum un fichier manifeste :

fxmanifest.lua : le format actuel, utilisé par la grande majorité des scripts récents.
__resource.lua : l'ancien format, encore présent dans certains scripts plus anciens. Il fonctionne toujours.

Le manifeste déclare les fichiers du script (client, serveur, fichiers partagés) et les dépendances éventuelles.

Installer une ressource

Téléchargez la ressource depuis la plateforme du développeur (GitHub, Tebex, cfx.re forums).
Extrayez le dossier si nécessaire. Vous devez obtenir un dossier contenant directement le fichier fxmanifest.lua, sans sous-dossier inutile.
Envoyez ce dossier dans le répertoire resources de votre serveur via l'onglet Files ou en SFTP. La plupart des frameworks organisent les ressources dans des sous-dossiers, par exemple resources/[scripts] ou resources/[esx].
Ouvrez le fichier server.cfg et ajoutez la ligne ensure nom_de_la_ressource.
Redémarrez le serveur ou tapez ensure nom_de_la_ressource dans la console txAdmin pour la charger sans redémarrer.

Gérer les dépendances

Beaucoup de scripts dépendent d'autres ressources. Les dépendances courantes :

oxmysql ou mysql-async : connexion à la base de données.
ox_lib : bibliothèque utilitaire utilisée par de nombreux scripts modernes.
es_extended (ESX) ou qb-core : le framework principal.

Les dépendances doivent être chargées avant le script qui en a besoin. Dans server.cfg, placez les lignes ensure dans le bon ordre, ou utilisez les dossiers entre crochets qui sont chargés alphabétiquement.

Résoudre les erreurs courantes

"No such resource" : le nom dans server.cfg ne correspond pas au nom du dossier. Vérifiez la casse et les tirets.
"Failed to load" : le fichier fxmanifest.lua contient une erreur de syntaxe, ou une dépendance manque.
Erreur SQL : le script nécessite des tables en base de données. Importez le fichier SQL fourni (souvent nommé install.sql ou database.sql) via phpMyAdmin.

Consultez toujours le README du script pour les instructions spécifiques. Si une ressource ne fonctionne pas, vérifiez la console pour les messages d'erreur. Pour de l'aide, ouvrez un ticket de support.