5 min de lecture
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 contientfxmanifest.luaqu'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
.zipde 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.cfgdepuis 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 dossierresourceslisible ; - 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. Leserver.cfget le dossierresourcesqui 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_tcpetendpoint_add_udpdeserver.cfgsont remises sur le port de ton serveur à chaque démarrage : ne les modifie pas. - La mémoire. FiveM tourne dès la formule Solo (4 Go) ; Duo (12 Go) et Squad (24 Go) donnent plus de marge. 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
Prêt à commencer ?
Sans engagement, garantie de remboursement 14 jours sur ta première souscription.
Voir le serveur FiveM →



