Ajouter des scripts sur FiveM, c'est ce qui transforme une carte vide en véritable serveur RP. La manipulation est simple, mais une erreur d'activation peut bloquer tout le serveur. Voici la méthode propre, étape par étape.
Scripts et ressources : de quoi parle-t-on ?
Sur FiveM, on utilise indifféremment les mots « script » et « ressource ». Une ressource est un dossier autonome contenant tout le nécessaire pour ajouter une fonctionnalité : du code Lua ou JavaScript, des éléments graphiques, parfois une partie de base de données.
C’est par ce système que vous construisez votre serveur :
- Un inventaire (ox_inventory, par exemple).
- Des jobs : police, ambulance, mécano, commerces.
- Des véhicules, garages et carburant.
- Des maps personnalisées (MLO) pour enrichir la ville.
Chaque ressource est indépendante, mais beaucoup dépendent les unes des autres. Comprendre cette logique est la clé pour éviter les erreurs au démarrage. Voyons maintenant comment en ajouter une proprement.
Étape 1 : placer la ressource dans le dossier resources
Toute ressource doit se trouver dans le dossier resources/ de votre serveur. C’est l’endroit que FiveM scanne au démarrage.
La marche à suivre :
- Téléchargez votre script depuis une source fiable (GitHub officiel, marketplace reconnue).
- Décompressez l’archive : vous obtenez un dossier contenant un fichier
fxmanifest.lua. - Déposez ce dossier dans
resources/. Beaucoup de créateurs rangent leurs scripts dans des sous-dossiers préfixés[esx],[scripts]ou[maps]pour s’organiser.
Le fxmanifest.lua est obligatoire : c’est lui qui décrit la ressource à FiveM. Sans ce fichier, le script ne sera jamais reconnu.
Bon à savoir : sur un hébergement géré, vous déposez vos ressources via FTP/SFTP directement dans le dossier resources/. Pas besoin d'accès au système : vos identifiants FTP figurent dans votre panel.
Étape 2 : activer le script avec ensure
Placer un dossier ne suffit pas : il faut dire à FiveM de le charger. Cela se fait dans le fichier server.cfg, en ajoutant une ligne :
ensure nom_du_scriptLe nom_du_script doit correspondre exactement au nom du dossier de la ressource, à la casse près. La directive ensure est aujourd’hui préférée aux anciennes start, car elle vérifie aussi que la ressource s’est bien lancée.
L’ordre des lignes compte. Une ressource doit être activée après ses dépendances. Par exemple, un script qui repose sur le framework ESX doit apparaître après la ligne qui active es_extended. Respecter cet ordre évite la moitié des erreurs de démarrage.
Étape 3 : gérer les dépendances
La plupart des scripts ont besoin d’autres ressources pour fonctionner. Un script de braquage de banque dépendra par exemple du framework, de l’inventaire et parfois d’un système de cibles (ox_target).
Avant d’activer un script, lisez sa documentation et vérifiez ses dépendances :
| Dépendance courante | Rôle |
|---|---|
| es_extended / qb-core | Le framework de base |
| oxmysql | Accès à la base de données |
| ox_inventory | Gestion des objets |
| ox_target / qb-target | Interactions à l’écran |
Activez toujours les dépendances avant le script qui les utilise. Une dépendance manquante ou mal ordonnée se traduit immédiatement par une erreur en console. Si votre serveur refuse de démarrer, notre guide serveur FiveM ne démarre pas vous aidera à isoler le coupable.
Étape 4 : tester et éviter les conflits
Ne jamais ajouter dix scripts d’un coup. La règle d’or est d’avancer par petits pas :
- Ajoutez une seule ressource à la fois.
- Redémarrez le serveur.
- Vérifiez la console : aucune erreur rouge ne doit apparaître.
- Testez la fonctionnalité en jeu avant de passer à la suivante.
Cette méthode rallonge un peu l’installation, mais vous fait gagner des heures de débogage. Quand quelque chose casse, vous savez exactement quel script en est responsable.
Pour détecter les conflits invisibles, certaines ressources partagent le même nom d’événement ou la même commande. La console signalera les doublons. Supprimez toujours les scripts que vous n’utilisez plus plutôt que de simplement les désactiver : un dossier oublié finit par créer de la confusion.
Étape 5 : surveiller les performances
Ajouter des scripts, c’est aussi ajouter de la charge. La commande resmon en jeu affiche le temps CPU consommé par chaque ressource en temps réel.
La règle simple : une ressource qui dépasse durablement 1 ms mérite votre attention. Multipliez cela par cinquante scripts et vous obtenez le lag. Privilégiez des ressources réputées optimisées, supprimez l’inutile et gardez votre base MySQL propre.
Le matériel joue aussi un rôle déterminant : un CPU à haute fréquence absorbe bien mieux une longue liste de scripts. C’est précisément ce que vous trouvez sur notre hébergement FiveM, pensé pour faire tourner un serveur RP fourni sans saccades.
En résumé
Ajouter un script sur FiveM tient en cinq gestes : déposer la ressource dans resources/, l’activer avec ensure dans le server.cfg, respecter l’ordre des dépendances, tester un script à la fois, puis surveiller les performances avec resmon. La rigueur dans l’ordre d’activation et l’ajout progressif sont vos meilleures protections contre les erreurs de démarrage. Avancez méthodiquement, et votre serveur restera stable à chaque nouvelle fonctionnalité.