Installation

Installer un script FiveM n’a rien de compliqué. Mais si tu ne l’as jamais fait, mieux vaut comprendre comment le serveur charge les scripts avant de te lancer.

Qu’est-ce qu’un script FiveM ?

Sur FiveM, les scripts s’appellent des ressources. Une ressource est un dossier qui contient tout ce dont un script a besoin pour tourner : fichiers client, fichiers serveur, fichiers de config et éventuels éléments d’UI.

Chaque dossier de ressource doit contenir un fichier nommé fxmanifest.lua. C’est lui qui indique au serveur quoi charger. Sans lui, le serveur ignore complètement le dossier.

Étape 1 : télécharger et extraire le script

Les scripts sont généralement fournis sous forme de fichier .zip ou .rar. Extrais-le avec 7-Zip ou WinRAR.

À l’intérieur, tu trouveras le dossier de la ressource. Il doit contenir au minimum :

• fxmanifest.lua
• Un ou plusieurs fichiers de script (client.lua, server.lua, config.lua, etc.)

Ne renomme pas le contenu du dossier, sauf si la documentation précise que c’est sans risque. Les chemins de fichiers dans fxmanifest.lua sont sensibles à la casse et doivent correspondre exactement aux vrais noms des fichiers.

Étape 2 : envoyer la ressource sur ton serveur

Les ressources se placent dans le dossier resources/ du répertoire de données de ton serveur. Une structure classique ressemble à ceci :

server-data/
└── resources/
    └── [scripts]/
        └── your-script/
            ├── fxmanifest.lua
            ├── client.lua
            └── server.lua

Les dossiers entre crochets comme [scripts] servent juste à ranger tes ressources par catégorie. Ce ne sont pas des ressources en eux-mêmes, et les scripts qu’ils contiennent fonctionnent normalement.

Envoie le dossier de la ressource par FTP, SFTP ou via le gestionnaire de fichiers du panel de ton hébergeur.

Étape 3 : configurer le script

La plupart des scripts incluent un fichier config.lua. Ouvre-le et règle les valeurs selon ton serveur. On y trouve en général le type de framework, les noms des métiers et les noms des items.

Lis la documentation avant de démarrer le script. Sauter cette étape, c’est la première cause d’un script qui ne marche pas après l’installation.

Étape 4 : ajouter le script au server.cfg

Ouvre server.cfg et ajoute cette ligne :

ensure your-script

Remplace your-script par le nom exact du dossier de la ressource. Les majuscules comptent.

Si le script dépend d’autres ressources comme ESX, QBCore ou ox_lib, vérifie qu’elles sont listées plus haut dans server.cfg pour qu’elles se chargent en premier.

ensure est la norme actuelle. Il démarre la ressource et la redémarre automatiquement si elle plante. L’ancienne directive start fonctionne toujours, mais ensure est à privilégier.

Étape 5 : démarrer la ressource

Pas besoin de redémarrer tout le serveur. Il y a deux façons de démarrer une ressource :

• txAdmin : va dans le panneau Resources, trouve le script et clique sur Start.
• Console du serveur : tape start your-script directement dans la console.

Regarde la sortie de la console pour repérer les erreurs. Si le script s’est bien chargé, tu verras :

Started resource your-script

Problèmes fréquents

En résumé

1. Extrais l’archive et repère le dossier de la ressource.
2. Envoie-le dans server-data/resources/.
3. Modifie config.lua selon la configuration de ton serveur.
4. Ajoute ensure your-script au server.cfg.
5. Démarre la ressource et vérifie la console pour repérer les erreurs.

La démarche est la même pour tous les scripts. Seule la configuration change.