🚓

Installer des ressources et des scripts sur un serveur FiveM

Du dossier téléchargé à la ressource qui tourne, sans rien casser

Sur FiveM, un script, une carte, un véhicule ou un framework entier sont tous la même chose : une ressource. Les installer suit toujours le même chemin, et la plupart des pannes viennent d'une seule étape sautée. Ce guide suit la documentation de Cfx.re et ce que ton panneau LobbyHost met à ta disposition.

Marche à suivre

Vérifie ce que tu as téléchargé

Décompresse l'archive sur ton ordinateur et ouvre le dossier. Une ressource valide contient un fichier fxmanifest.lua : sans lui, FiveM ne la reconnaît pas. Si tu trouves un dossier dans un dossier, c'est celui qui contient fxmanifest.lua qu'il faudra envoyer. Lis aussi le fichier d'instructions de l'auteur : il liste les dépendances.

Prends une sauvegarde

Dans ton panneau, ouvre le tiroir Sauvegardes et clique sur « Créer une sauvegarde maintenant ». Une ressource mal écrite peut empêcher le serveur de démarrer : tu veux pouvoir revenir à l'état d'avant.

Envoie la ressource dans le dossier resources

Deux chemins. Le tiroir Ajouter une ressource prend une archive .zip de 200 Mo au plus et la range dans /resources ; ouvre ensuite Fichiers et clique sur « Décompresser » à côté d'elle. Pour un dossier entier ou un gros pack, passe par le tiroir Accès SFTP et envoie le dossier avec FileZilla, WinSCP ou Cyberduck.

Importe sa base de données, si elle en a une

Si la ressource fournit un fichier .sql, ouvre le tiroir Base de données, crée une base si ce n'est pas fait, puis clique sur « Ouvrir l'éditeur » pour importer le fichier. Recopie les identifiants affichés dans la configuration de ton framework.

Déclare-la dans server.cfg

Ouvre server.cfg depuis Fichiers et ajoute une ligne avec le nom exact du dossier :

ensure nom_de_la_ressource

Place cette ligne après celles des ressources dont elle dépend : le framework d'abord, les scripts qui l'utilisent ensuite.

Redémarre et lis la console

Redémarre le serveur depuis ton panneau ou depuis txAdmin, puis ouvre Console & commandes. Une ressource chargée s'annonce au démarrage ; une ressource en échec affiche une erreur qui nomme le fichier fautif.

Comment FiveM range ses ressources

La documentation de Cfx.re définit une ressource comme un ensemble de fichiers — scripts côté client, scripts côté serveur, éléments à diffuser aux joueurs — qui peut être démarré, arrêté et relancé à tout moment. Trois règles suffisent à s'y retrouver :

chaque ressource est un dossier qui contient un fxmanifest.lua. Les anciennes ressources utilisent encore __resource.lua, aujourd'hui déprécié ;

un dossier dont le nom est entre crochets, comme [voitures] ou [metiers], n'est pas une ressource : c'est un classeur qui en regroupe plusieurs. Sers-t'en pour garder un dossier resources lisible ;

une ressource porte le nom de son dossier. C'est ce nom, à la lettre près, qui s'écrit après ensure.

ensure, start, et l'ordre des lignes

Dans server.cfg, ensure démarre une ressource, ou la relance si elle tournait déjà ; c'est la commande à utiliser par défaut. Les lignes sont lues de haut en bas : une ressource écrite avant celle dont elle dépend démarre dans le vide et affiche des erreurs. L'ordre qui évite le plus d'ennuis :

les ressources de base livrées avec le serveur ;

la liaison avec la base de données ;

le framework (ESX, QBCore ou Qbox) ;

les scripts qui s'appuient sur le framework ;

les cartes et les véhicules ajoutés.

Si txAdmin gère ton serveur

txAdmin est l'interface d'administration fournie par Cfx.re. Chez LobbyHost il est installé avec ton serveur et s'active dans « Paramètres de lancement » ; la tuile « Tableau de bord txAdmin » de ton panneau t'y emmène ensuite. Deux conséquences pour l'installation de ressources :

txAdmin déploie le serveur dans son propre dossier de données, sous txData. Le server.cfg et le dossier resources qui comptent sont alors ceux de ce dossier-là, pas ceux de la racine. Vérifie où tu poses tes fichiers avant de conclure qu'une ressource est introuvable ;

depuis txAdmin, tu peux relancer une ressource seule, sans couper le serveur ni déconnecter tes joueurs. C'est le moyen le plus rapide de tester une modification.

Les limites à connaître

La taille d'envoi. Le dépôt par le panneau est limité à 200 Mo par fichier. Au-delà, l'accès SFTP n'a pas de limite.

Le nombre de joueurs. D'après la documentation de Cfx.re, OneSync est gratuit jusqu'à 48 places ; aller plus haut demande un abonnement pris chez Cfx.re. Ton serveur est livré réglé sur 48.

La version du jeu. Certaines cartes et certains véhicules exigent une version précise de GTA V. Elle se règle dans « Paramètres de lancement », réglage « Version du jeu GTA V imposée ».

Les lignes de port. Les lignes endpoint_add_tcp et endpoint_add_udp de server.cfg sont remises sur le port de ton serveur à chaque démarrage : ne les modifie pas.

La mémoire. FiveM est proposé avec les formules Duo (12 Go) et Squad (24 Go). Chaque carte et chaque pack de véhicules ajoutés pèsent : vois combien de RAM pour un serveur de jeu et la page tarifs.

FiveM ne fait pas partie des jeux pour lesquels le panneau installe un mod à partir d'une adresse Steam Workshop ou Modrinth : la liste de ces jeux est sur la page mods.

Questions fréquentes

Où placer une ressource sur un serveur FiveM ?

Dans le dossier resources du serveur, directement ou à l'intérieur d'un dossier classeur dont le nom est entre crochets. Si txAdmin gère ton serveur, c'est le dossier resources de son dossier de données, sous txData, qui est utilisé.

Pourquoi ma ressource n'est-elle pas trouvée ?

Le plus souvent parce que la décompression a créé un dossier dans un dossier. Le fichier fxmanifest.lua doit se trouver directement dans le dossier dont tu écris le nom après ensure dans server.cfg.

Quelle différence entre ensure et start ?

La commande ensure démarre la ressource, ou la relance si elle tournait déjà. C'est celle qu'il faut utiliser par défaut dans server.cfg.

Comment installer une ressource qui a besoin d'une base de données ?

Crée une base dans le tiroir « Base de données » de ton panneau, ouvre l'éditeur pour importer le fichier .sql fourni avec la ressource, puis recopie les identifiants affichés dans la configuration de ton framework.

Faut-il redémarrer tout le serveur après chaque ajout ?

Pour une première installation, oui : le serveur doit relire server.cfg. Pour tester ensuite une modification, txAdmin permet de relancer une ressource seule, sans déconnecter les joueurs.