Ajouter un script ou une ressource à son serveur FiveM
vous ajoutez un script (une « ressource ») à votre serveur FiveM, le déclarez dans `server.cfg` et vérifiez qu’il se charge.
Avant de commencer
- Une ressource est un dossier de script FiveM : véhicules, métiers, interfaces, cartes… Les sites de scripts gratuits ou payants en distribuent sous forme de dossier ou d’archive
.zip. - Vérifiez que la ressource est compatible avec votre framework (Qbox, QBCore, ESX…) : une ressource écrite pour ESX ne marche pas sur Qbox sans adaptation.
- Il vous faut une sauvegarde de votre
server.cfg: copiez le fichier avant de le modifier, ou utilisezserver.cfg.bkpquand il existe.
Trouver le bon dossier de ressources
Avec txAdmin, les fichiers du serveur sont dans txData/<nom de la recette>.base/ : par exemple txData/Qbox_FC1A36.base/. C’est là que se trouvent le vrai server.cfg et le dossier resources. Le server.cfg et le dossier resources posés à la racine du serveur sont ceux d’un modèle par défaut : ne les modifiez pas, ils ne sont pas ceux de votre jeu. Dans le dossier resources, les sous-dossiers entre crochets ([standalone], [qbx], [ox]…) servent à ranger : le jeu les parcourt tous.
Envoyer la ressource
Dans le gestionnaire de fichiers ou en SFTP, envoyez le dossier de la ressource dans resources/[standalone] (le dossier pour les ressources indépendantes). Le dossier doit contenir un fichier fxmanifest.lua à sa racine : sans lui, FiveM ne la reconnaît pas. Si vous recevez un .zip, décompressez-le d’abord pour que fxmanifest.lua soit directement dans le dossier de la ressource, et non dans un sous-dossier de plus.
Exemple minimal (notre test) : un dossier wiki_demo contenant fxmanifest.lua (fx_version 'cerulean', game 'gta5', server_script 'server.lua') et server.lua (une ligne print(...)).
Déclarer la ressource dans server.cfg
Ouvrez server.cfg (celui du dossier de l’étape 1) et ajoutez une ligne ensure nom_du_dossier, après les ressources dont elle dépend (par exemple après ensure qbx_core pour un script Qbox) :
ensure wiki_demo
Le nom est celui du dossier de la ressource. Enregistrez.
Redémarrer et vérifier
Redémarrez le serveur depuis le panel. Attendez deux à trois minutes. Pour vérifier que la ressource est chargée, ouvrez http://IP:port/info.json : la liste resources contient le nom de votre ressource. Nous l’avons testé : la liste est passée de 82 à 83 ressources avec wiki_demo. Vous pouvez aussi lire la console de txAdmin, qui affiche « Started resource … ».
Les commandes en direct
txAdmin propose une console en direct où les commandes refresh (relire les dossiers) puis ensure nom chargent une ressource sans redémarrer. Attention : nous avons tapé ces commandes dans la console du panel, et elles n’ont eu aucun effet (la ressource ne s’est pas chargée) : pour FiveM, utilisez la console de txAdmin, ou redémarrez.
Si ça ne marche pas
La ressource ne se charge pas
fxmanifest.lua est absent ou mal placé (un sous-dossier de trop), ou le nom dans ensure ne correspond pas au nom du dossier.
Une erreur « could not find dependency »
une autre ressource doit être chargée avant. Placez votre ensure après la sienne.
Le serveur plante au démarrage après un ajout
retirez la ligne ensure ajoutée (ou remettez server.cfg.bkp) et redémarrez.
Le redémarrage reste bloqué sur « Arrêt en cours »
patientez deux minutes ; sinon, utilisez le bouton Tuer puis Démarrer (voir le rapport des défauts du panel).
Le script ne marche pas en jeu
lisez la console de txAdmin et le journal F8 en jeu ; vérifiez le framework et la configuration propre au script (un fichier config.lua en général).
Une question ? Écrivez-nous
Notre équipe vous répond, en français, par message ou sur Discord.