Tu installes des scripts FiveM en plaçant la ressource dans le dossier resources/, en la démarrant dans server.cfg avec ensure et en chargeant au préalable les dépendances comme ESX, QBCore ou les pilotes de base de données. Les points décisifs sont une structure de dossiers propre, le bon ordre de démarrage, un import SQL vérifié et un coup d’œil à la console serveur après le redémarrage.
Conditions préalables
Tu as besoin d’un accès aux fichiers serveur, à server.cfg, à la console serveur et, si le script utilise des tables de base de données, à ta base MySQL ou MariaDB. Avec un serveur FiveM loué, cela inclut généralement un gestionnaire de fichiers, FTP/SFTP et un outil de base de données comme phpMyAdmin ou Adminer. Si tu planifies encore le serveur complet, le guide interne Louer et configurer un serveur FiveM t’aide pour la structure de base.
Techniquement, FiveM appelle les scripts des ressources. Selon la documentation officielle Cfx.re, fxmanifest.lua décrit les fichiers, scripts et métadonnées qui appartiennent à une ressource. Vérifie donc toujours d’abord si le dossier décompressé contient un fichier manifeste valide. Sans manifeste, le serveur ne peut pas charger correctement la ressource.
Vérifier la structure du script
Une ressource FiveM typique ressemble à ceci :
mon_script/
├── fxmanifest.lua # Fichier manifeste
├── client.lua # Code client
├── server.lua # Code serveur
├── config.lua # Configuration
└── html/ # NUI (interface web)
Il est important de ne pas téléverser par erreur un dossier d’emballage supplémentaire. Par exemple, resources/mon_script-main/mon_script/fxmanifest.lua serait incorrect si la ressource doit en réalité se trouver directement sous resources/mon_script/fxmanifest.lua. Après la décompression, ouvre le dossier et contrôle le niveau où se trouve fxmanifest.lua.
Installer le script
- Télécharger le script
- Le décompresser dans le dossier
resources/ - L’ajouter dans
server.cfg:
ensure mon_script
- Redémarrer le serveur
Utilise comme nom de ressource exactement le nom du dossier ou le nom indiqué par le README. Beaucoup d’erreurs viennent de variantes d’écriture, d’espaces dans le nom du dossier ou de caractères spéciaux. Les noms courts en minuscules, avec des tirets ou des underscores, sont recommandés.
Configurer les scripts ESX
Les scripts ESX dépendent du démarrage préalable de la base ESX et des ressources supplémentaires nécessaires. L’ordre exact peut varier selon la version d’ESX et le script, donc la règle est la suivante : vérifier le README du script et respecter la documentation du framework existante.
# Base ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Jobs
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob
# Fonctionnalités
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property
Si un script de job attend ses propres tables de base de données ou items, importe le fichier SQL fourni avant le premier démarrage en production. Sauvegarde la base de données au préalable. Sur les serveurs roleplay existants, les fichiers SQL peuvent écraser des colonnes, items ou jobs s’ils ne sont pas adaptés à ton installation.
Configurer les scripts QBCore
Les ressources QBCore suivent un principe similaire : d’abord le framework, puis les bibliothèques communes, ensuite l’inventaire, les jobs, les garages, le phone ou le HUD. Un exemple simple :
ensure qb-core
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-garages
ensure qb-inventory
ensure qb-phone
Vérifie particulièrement les fichiers de configuration comme config.lua, shared/config.lua ou les fichiers d’items spécifiques au framework. Certains scripts QBCore attendent des entrées dans les items, jobs, gangs ou permissions. N’ajoute que les valeurs documentées par le script. Si tu veux planifier les ressources, txAdmin et l’exploitation serveur dans un contexte plus large, lis aussi Louer un serveur FiveM : configurer GTA RP, ressources & txAdmin 2025.
Respecter l’ordre de démarrage
L’ordre de démarrage est important :
- Framework d’abord (ESX/QBCore)
- Dependencies (oxmysql, etc.)
- Scripts de base (inventaire, HUD)
- Scripts de jobs
- Scripts cosmétiques (emotes, vêtements)
Place autant que possible les dependencies communes de manière centrale et avant toutes les ressources qui en dépendent. Si plusieurs scripts demandent la même bibliothèque, elle ne doit être démarrée qu’une seule fois. Avec une connexion à une base de données, le pilote de base de données doit fonctionner avant que les ressources n’envoient des requêtes SQL.
Sources de scripts gratuites
| Source | Description |
|---|---|
| GitHub | Scripts open source |
| Forum cfx.re | Scripts communautaires |
| Overextended | Open source de haute qualité |
Télécharge des scripts uniquement depuis des sources qui rendent le code, le changelog ou les retours de la communauté vérifiables. Avec les téléchargements inconnus, fais particulièrement attention au code Lua obfusqué, aux requêtes HTTP inexpliquées, aux webhooks externes et aux tokens codés en dur. Installe d’abord les nouvelles ressources sur une instance de test ou en dehors des heures de jeu principales.
Vérifier le résultat
Redémarre le serveur et observe la console. Une ressource correctement chargée apparaît sans erreur de manifeste, de dependency ou de SQL. En jeu, vérifie ensuite précisément la fonction fournie par le script : menu de job, interaction d’inventaire, marqueur, commande, fenêtre NUI ou modification de base de données. Teste avec les rôles et droits que les vrais joueurs utiliseront plus tard.
Utilise en plus refresh et ensure mon_script dans la console serveur uniquement pour des tests contrôlés. Pour les changements en production, un redémarrage propre est souvent plus parlant, car il reproduit l’ordre de démarrage complet.
Dépannage
SCRIPT ERROR
Vérifie d’abord la ligne dans la console. Souvent, une dependency manque, une variable de configuration est mal définie ou une fonction exportée est appelée avant le démarrage de la ressource cible. Compare le message d’erreur avec le README du script.
Erreur SQL
Importe les tables ou colonnes fournies si le script les exige. Si les tables existent déjà, n’exécute pas le SQL aveuglément une nouvelle fois. Crée une sauvegarde et adapte les statements à ta structure de base de données existante.
Le script ne se charge pas
Contrôle le nom du dossier, l’entrée ensure et fxmanifest.lua. Une faute de frappe dans le fichier manifeste ou un dossier mal imbriqué suffit pour empêcher la ressource de démarrer.
La fonction n’apparaît pas en jeu
Vérifie les droits, jobs, items, coordonnées et la version du framework. Beaucoup de scripts roleplay fonctionnent seulement pour certains jobs ou groupes. Ne teste donc pas seulement en admin, mais aussi avec un profil de joueur normal.
Vérification, limites et retour arrière sûr
Le guide « Installer des scripts FiveM Server – ESX et QBCore » s’applique au type de serveur décrit dans l’article et à l’état des versions visible au moment de la vérification. Les noms de menus, versions disponibles, compatibilités de mods ou plugins et ressources nécessaires peuvent changer après des mises à jour. Ne transfère donc aucune valeur sans vérification vers une autre version de jeu, de loader ou de serveur.
Avant toute modification de monde, sauvegarde, configuration ou extension, crée une sauvegarde des fichiers concernés. Modifie ensuite seulement une étape cohérente à la fois et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer plus tard.
| Point de contrôle | Résultat attendu | Arrêt et retour arrière |
|---|---|---|
| Démarrage du serveur | Le serveur atteint l’état opérationnel sans nouveau message d’erreur. | En cas d’erreurs au démarrage, annuler la modification et restaurer la dernière sauvegarde. |
| Test de connexion | Un compte de test peut se connecter via l’adresse affichée dans le panel. | En cas d’erreurs de version ou de connexion, revérifier la version, le port et les autorisations. |
| Test fonctionnel | La fonction précisément modifiée fonctionne sans endommager les données de monde ou de jeu existantes. | En cas d’effets secondaires, arrêter le serveur et restaurer les fichiers sauvegardés. |
Un test individuel réussi n’est pas une garantie de performance ou de disponibilité. La taille du monde, les mods, plugins, le nombre de joueurs, le chemin réseau et la charge simultanée peuvent modifier le résultat. Documente la version, la modification et le résultat du test afin de pouvoir comprendre les écarts ultérieurs.
FAQ
Dois-je redémarrer le serveur après chaque script ?
Pour un test fiable, oui. Certaines ressources peuvent certes être rechargées via la console, mais un redémarrage complet montre si l’ordre de démarrage et toutes les dependencies sont vraiment corrects.
Puis-je utiliser ESX et QBCore en même temps ?
En pratique, tu devrais choisir un seul framework. Beaucoup de scripts sont clairement conçus pour ESX ou QBCore et attendent à chaque fois d’autres events, tables et structures de configuration.
Que faire si un script n’a pas de fxmanifest.lua ?
Il est peut-être obsolète, mal décompressé ou non préparé pour les structures de ressources FiveM actuelles. Vérifie la source et la documentation avant de l’installer en production.
Dois-je tester les scripts gratuits directement sur le serveur live ?
Mieux vaut éviter. Teste d’abord les nouvelles ressources séparément, sauvegarde les fichiers et la base de données, puis vérifie la console. Sur les serveurs roleplay en particulier, des scripts défectueux peuvent affecter l’inventaire, les jobs ou la progression des joueurs.
Combien de scripts un serveur FiveM peut-il utiliser ?
Il n’existe pas de chiffre global pertinent. Ce qui compte, c’est la qualité des scripts, les dépendances, la charge de la base de données, le comportement des ticks et le nombre de joueurs. Planifie les ressources consciemment et supprime systématiquement les scripts inutilisés.