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 avant elle les dépendances comme ESX, QBCore ou les pilotes de base de données. Une structure de dossiers propre, le bon ordre de démarrage, un import SQL vérifié et un coup d'œil à la console du serveur après le redémarrage sont déterminants.
Prérequis
Tu as besoin d'un accès aux fichiers du serveur, au server.cfg, à la console du serveur et, si le script utilise des tables de base de données, à ta base MySQL ou MariaDB. Pour un serveur FiveM loué, cela comprend en général un gestionnaire de fichiers, FTP/SFTP et un outil de base de données comme phpMyAdmin ou Adminer. Si tu es encore en train de planifier le serveur complet, le guide interne Louer et configurer un serveur FiveM t'aide pour la structure de base.
FiveM appelle techniquement les scripts des ressources. Selon la documentation officielle de Cfx.re, le fichier fxmanifest.lua décrit quels fichiers, scripts et métadonnées font partie d'une ressource. Vérifie donc toujours d'abord que 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. Ce serait par exemple incorrect : resources/mon_script-main/mon_script/fxmanifest.lua, alors que la ressource devrait se trouver directement sous resources/mon_script/fxmanifest.lua. Après la décompression, ouvre le dossier et contrôle le niveau auquel 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. De nombreuses erreurs viennent d'orthographes divergentes, d'espaces dans le nom du dossier ou de caractères spéciaux. Des noms courts en minuscules, avec des tirets ou des tirets bas, sont recommandés.
Configurer des scripts ESX
Les scripts ESX dépendent du fait que la base ESX et les ressources supplémentaires nécessaires soient démarrées avant. L'ordre précis peut varier selon la version d'ESX et le script, donc : consulte le README du script et la documentation du framework disponible.
# Base ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Métiers
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 métier attend ses propres tables de base de données ou objets, importe le fichier SQL fourni avant le premier démarrage en production. Sauvegarde la base de données au préalable. Sur des serveurs de roleplay existants, les fichiers SQL peuvent écraser des colonnes, des objets ou des métiers s'ils ne sont pas adaptés à ton installation.
Configurer des scripts QBCore
Les ressources QBCore ont besoin de leurs dépendances avant le framework ou avant le script concerné. L'exemple suivant suppose que ces versions utilisent oxmysql ; tu ajoutes les dépendances supplémentaires du README au bon endroit :
ensure oxmysql
ensure qb-core
ensure qb-inventory
ensure qb-garages
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-phone
Vérifie en particulier les fichiers de configuration comme config.lua, shared/config.lua ou les fichiers d'objets propres au framework. Certains scripts QBCore attendent des entrées dans les objets, les métiers, les gangs ou les permissions. Ne saisis que les valeurs documentées par le script. Si tu veux planifier les ressources, txAdmin et l'exploitation du serveur dans un contexte plus large, lis aussi Louer un serveur FiveM : configurer un GTA RP, ressources et txAdmin 2025.
Respecter l'ordre de démarrage
L'ordre de démarrage suit les dépendances réellement documentées :
- Pilotes de base de données et bibliothèques communes, par exemple
oxmysql, si requis - Framework comme ESX ou QBCore
- Ressources de base, par exemple l'inventaire ou les garages
- Métiers et autres fonctionnalités qui utilisent cette base
- Ressources cosmétiques, dans la mesure où leurs propres dépendances sont déjà lancées
Une entrée dependency dans le manifeste décrit un prérequis. D'après la référence du manifeste de Cfx.re, la ressource concernée doit se charger avant la ressource dépendante. Le README de la version installée détermine l'ordre exact.
Place les dépendances partagées de préférence de façon centralisée et avant toutes les ressources dépendantes. Si plusieurs scripts exigent la même bibliothèque, elle ne doit être démarrée qu'une seule fois. Pour la connexion à la base de données, le pilote de base de données doit tourner avant que les ressources n'envoient des requêtes SQL.
Sources de scripts gratuits
| Source | Description |
|---|---|
| GitHub | Scripts open source |
| Cfx.re Releases-Forum | Scripts de la communauté |
| 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 des téléchargements inconnus, fais particulièrement attention au code Lua obfusqué, aux requêtes HTTP inexpliquées, aux webhooks étrangers et aux jetons 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 dépendance ou de SQL. En jeu, tu vérifies ensuite précisément la fonction que fournit le script : menu de métier, interaction d'inventaire, marqueur, commande, fenêtre NUI ou modification de la base de données. Teste avec les rôles et les droits que les vrais joueurs utiliseront plus tard.
Utilise en plus refresh et ensure mon_script dans la console du serveur uniquement pour des tests contrôlés. Pour les modifications en production, un redémarrage propre est souvent plus fiable, car il reproduit l'ordre de démarrage complet.
Dépannage
SCRIPT ERROR
Vérifie d'abord la ligne dans la console. Souvent, une dépendance 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.
Erreurs SQL
Importe les tables ou colonnes fournies si le script les exige. Si des tables existent déjà, n'exécute pas le SQL de nouveau à l'aveugle. Crée une sauvegarde et adapte les instructions à la structure existante de ta base de données.
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 que la ressource ne démarre pas.
La fonction n'apparaît pas en jeu
Vérifie les droits, les métiers, les objets, les coordonnées et la version du framework. De nombreux scripts de roleplay ne fonctionnent que pour certains métiers ou groupes. Teste donc non seulement en tant qu'admin, mais aussi avec un profil de joueur normal.
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 dépendances sont vraiment corrects.
Puis-je utiliser ESX et QBCore en même temps ?
En pratique, tu devrais choisir un seul framework. De nombreux scripts sont clairement conçus pour ESX ou QBCore et attendent chacun d'autres événements, tables et structures de configuration.
Que faire si un script n'a pas de fxmanifest.lua ?
Vérifie aussi si un ancien manifeste __resource.lua est présent. Cfx.re documente toujours ce format comme obsolète ; l'absence de fxmanifest.lua seule ne prouve donc pas qu'un téléchargement est défectueux. Pour les nouvelles ressources, utilise le format actuel et migre les anciennes selon la référence du manifeste. Ne renomme pas simplement l'ancien fichier sans vérifier sa syntaxe et son contenu.
Dois-je tester des scripts gratuits directement sur le serveur en production ?
Mieux vaut ne pas le faire. Teste d'abord les nouvelles ressources séparément, sauvegarde les fichiers et la base de données et vérifie la console. Surtout sur les serveurs de roleplay, des scripts défectueux peuvent affecter l'inventaire, les métiers ou la progression des joueurs.
Combien de scripts un serveur FiveM peut-il utiliser ?
Il n'existe pas de nombre global pertinent. La qualité des scripts, les dépendances, la charge de la base de données, le comportement des ticks et le nombre de joueurs sont déterminants. Planifie les ressources avec soin et supprime systématiquement les scripts inutilisés.
