FiveM : installer des ressources, en un clic ou par SFTP

Tu peux utiliser des ressources pour ajouter des fonctionnalités à ton serveur de jeu FiveM. C’est particulièrement intéressant si tu prévois un projet de grande envergure, comme un serveur roleplay ou autre. Difficile de se passer de ces ressources supplémentaires pour ce type de projet.

FiveM et sa communauté proposent un immense choix de ressources. Tu trouveras un aperçu des ressources les plus populaires sur le forum Cfx.re : https://forum.cfx.re/c/development/releases/7

Le moyen le plus rapide d’installer une ressource est d’utiliser le FiveM Resource Installer, directement depuis le tableau de bord. Téléverse l’archive ZIP : l’outil place la ressource dans le bon dossier, l’ajoute à la server.cfg et, si tu le souhaites, importe les fichiers SQL fournis dans ta base de données. Tu trouveras plus bas la méthode classique par SFTP.

Ouvre le tableau de bord de ton serveur FiveM, accède à l’onglet Outils, puis sélectionne FiveM Resource Installer. Tu n’as pas besoin d’arrêter ton serveur.

Pour cela, un modèle de serveur (Recipe) doit déjà être configuré dans txAdmin. C’est à cette condition que les fichiers server.cfg et le dossier resources sont créés et que l’outil peut y écrire.

Téléverse la ressource sous forme d’archive ZIP. Tu peux directement utiliser un téléchargement GitHub via Code → Download ZIP ou une archive ZIP de publication.

• Les fichiers ZIP sont limités à 100 Mo (400 Mo et 5 000 fichiers maximum une fois décompressés).
• Si tu as une archive RAR ou 7z, compresse-la à nouveau au format ZIP.
• L’outil supprime les dossiers intermédiaires inutiles (par exemple, ma-ressource-main), ainsi que les numéros de version et les suffixes -main du nom.
• Si une archive contient plusieurs ressources, l’outil les répertorie séparément et les trie en fonction de leurs dépendances.
• Les fichiers exécutables comme .exe, .bat ou .sh ne sont jamais écrits sur ton serveur.

Avant l’installation, l’outil t’indique le contenu de l’archive :

• Nom et dossier de destination : Le nom peut contenir des lettres, des chiffres, ainsi que _, . et - (64 caractères maximum). Sous Dossier dans resources/, choisis le dossier de catégorie, par exemple [standalone]. Si l’archive n’en contient pas, [local] est sélectionné par défaut. Avec Directement dans resources/ (sans dossier), la ressource est placée sans dossier de catégorie.
• Dépendances : Pour chaque dépendance (par exemple ESX, QBCore, Qbox, ox_lib, oxmysql), tu peux voir si elle se trouve dans l’archive, si elle est présente sur le serveur ou si elle y est manquante. Les dépendances mentionnées uniquement dans le code et absentes de fxmanifest.lua sont signalées comme supposées.
• Analyse de sécurité : L’outil vérifie tous les fichiers .lua et .js pour détecter des signatures de code malveillant connues. En cas de détection, tu reçois un avertissement. Tu peux quand même procéder à l’installation, mais l’analyse de sécurité désactive la ressource au prochain démarrage du serveur. Si tu penses qu’il s’agit d’une fausse alerte, contacte notre support.
• Fichiers SQL : Les fichiers .sql fournis sont répertoriés avec une indication des tables qu’ils créent, modifient ou remplissent.

Si la ressource existe déjà sur ton serveur, l’outil interrompt l’installation par défaut. Pour la remplacer (par exemple, pour la mettre à jour), coche Écraser la ressource existante. Le dossier entier sera alors remplacé, y compris tes paramètres comme config.lua. Avant cela, l’ancien dossier est sauvegardé sous forme d’archive dans backups/resource-installer/.

Laisse cochée l’option Ajouter à server.cfg pour un démarrage automatique. L’outil ajoute alors ensure <Name> à la server.cfg de ton dossier de serveur actif, après les dépendances de la ressource, et sauvegarde d’abord l’ancienne server.cfg sous le nom server.cfg.bak-….

Clique sur Installer sur le serveur. Tu peux suivre la progression (sauvegarde, décompression, placement, ajout à server.cfg, vérification du résultat). L’installation continue même si tu fermes la page.

Le résultat indique comment la ressource démarre :

• Ligne ensure ajoutée à server.cfg : tout est prêt.
• déjà présent dans server.cfg : la ligne était déjà présente.
• Démarre via le dossier de catégorie : ta server.cfg contient déjà ensure [Catégorie], ce qui lance également la ressource.
• Ligne ensure encore manquante : ajoute toi-même ensure <Name> à la server.cfg (voir Activation).

Pour que FiveM charge la nouvelle ressource, redémarre le serveur en cliquant sur Redémarrer le serveur. Tu peux aussi saisir refresh, puis ensure <Name> dans la console en direct.

Si la ressource a besoin d’une base de données, tu peux importer son fichier SQL directement depuis l’outil. L’importation n’est pas automatique : tu dois cliquer sur Importer dans la base de données pour le fichier concerné.

1. Sélectionne la base de données de ton serveur. La base de données principale est présélectionnée. Si ton serveur n’a pas encore de base de données, crée-en une en cliquant sur Créer une base de données dans l’onglet Bases de données.
2. Si des tables du fichier existent déjà, la fenêtre te l’indique. Dans ce cas, laisse sélectionnée l’option Ignorer les tables existantes (recommandé). Les tables existantes et leurs données ne seront ainsi pas modifiées.
3. Si ton ZapX Pass est actif, une sauvegarde de la base de données est automatiquement créée avant l’importation. Sans Pass, confirme J’importe sans Backup.
4. Clique sur Importer maintenant.

Chaque fichier peut contenir jusqu’à 2 Mo et 5 000 instructions SQL. Pour importer des fichiers plus volumineux, suis les instructions de l’article FiveM : importer un fichier SQL et utilise phpMyAdmin.