Installer une ressource sur un serveur FiveM en 2026

Une ressource FiveM est un dossier qui regroupe des scripts client, des scripts serveur et parfois des fichiers de contenu. Le serveur peut la démarrer, l’arrêter ou la redémarrer à chaud, sans toucher au reste de la partie. Installer une ressource FiveM revient donc à trois gestes : poser le dossier au bon endroit, vérifier son manifeste, puis le déclarer dans la configuration du serveur.

La méthode décrite ici s’applique aux builds FXServer actuels, ceux dont le manifeste déclare fx_version 'cerulean'. Elle a été recoupée le 4 août 2026 avec la documentation Cfx.re. Comptez une dizaine de minutes pour un script autonome, davantage si la ressource dépend d’un framework. Résultat attendu : la ressource se lance sans avertissement dans la console et redémarre d’elle-même à chaque relance du serveur.

Où FXServer va chercher les ressources

Sur le serveur, les ressources sont chargées depuis un dossier resources/ situé dans le répertoire de données du serveur, celui qui contient également server.cfg. Tout dossier placé dans resources/ est analysé comme une ressource, à une exception près : les dossiers dont le nom est entouré de crochets, comme [cars], sont des catégories. Une catégorie ne contient pas de code, elle sert à regrouper plusieurs ressources.

server
└── resources
    ├── [categorie]
    │   ├── ressource-1
    │   │   └── fxmanifest.lua
    │   └── ressource-2
    │       └── fxmanifest.lua
    └── ma-ressource
        └── fxmanifest.lua

Cette organisation a un intérêt pratique : une catégorie entière se démarre en une seule ligne, avec start [categorie]. Chaque dossier de ressource, en revanche, doit contenir un fichier fxmanifest.lua à sa racine. Ce manifeste indique au serveur quels fichiers appartiennent à la ressource et quels scripts exécuter côté client ou côté serveur. Sans lui, le dossier n’est pas reconnu comme une ressource. Le détail des clés disponibles figure dans la référence du manifeste de ressource.

Sauvegarder server.cfg et le dossier resources

Ajouter une ressource n’efface rien en soi, mais le téléversement peut écraser des données. Si le dossier envoyé porte le même nom qu’un dossier déjà présent, la plupart des clients FTP et des gestionnaires de fichiers remplacent les fichiers existants sans demander confirmation. Une ressource déjà configurée peut ainsi perdre ses réglages, et un server.cfg réécrit fait disparaître toutes les lignes précédentes.

Avant toute manipulation, récupérez une copie de server.cfg et du dossier resources/, ou déclenchez une sauvegarde depuis votre panel d’hébergement. Cette copie est votre point de retour : c’est elle qui permettra de revenir à l’état d’origine si la nouvelle ressource empêche le serveur de démarrer.

Récupérer la ressource depuis une source officielle

La documentation Cfx.re renvoie vers deux endroits pour trouver des ressources : le Cfx Marketplace et la section Releases du forum officiel. Le forum propose des filtres, dont un tag standalone qui regroupe les ressources ne dépendant d’aucune autre.

Deux points méritent attention avant de télécharger. D’abord les dépendances : beaucoup de scripts s’appuient sur un framework ou sur une bibliothèque tierce et ne démarreront pas si celle-ci est absente ou chargée trop tard. Ensuite la responsabilité : la documentation officielle rappelle que les ressources sont communautaires, qu’elles s’utilisent à vos risques et que le support FiveM ne les couvre pas. Pour une ressource payante, elle recommande de passer par le Cfx Marketplace ou par Tebex afin d’éviter les arnaques. Les conditions d’utilisation fixées par l’auteur s’appliquent dans tous les cas.

Déposer le dossier au bon endroit

Décompressez l’archive sur votre poste, et non directement sur le serveur. Ouvrez le dossier obtenu et vérifiez qu’il contient bien fxmanifest.lua à sa racine. L’erreur la plus courante vient d’un dossier imbriqué : l’archive produit ma-ressource/ma-ressource/fxmanifest.lua, et c’est le dossier intérieur qu’il faut envoyer.

Renommez ensuite le dossier en minuscules, sans espace ni accent. Sous Linux, la casse est significative : une ressource dont le dossier s’appelle MaRessource ne répondra pas à ensure ma-ressource. Sous Windows, la casse est ignorée, ce qui masque le problème jusqu’à une éventuelle migration. Téléversez enfin le dossier dans resources/, ou dans l’une de vos catégories existantes.

Déclarer la ressource dans server.cfg

Le serveur ne démarre que les ressources listées dans server.cfg. Ouvrez ce fichier et ajoutez la ligne correspondante. La documentation Cfx.re décrit quatre commandes de gestion des ressources :

• start démarre la ressource si elle était arrêtée ;
• stop l’arrête si elle était démarrée ;
• ensure la redémarre si elle tournait, et la démarre sinon ;
• restart la redémarre si elle était démarrée.

C’est ensure qu’il faut privilégier dans server.cfg : le résultat est le même quel que soit l’état de la ressource au moment où le fichier est lu. L’ordre des lignes compte également, car les dépendances doivent être démarrées avant les ressources qui les utilisent.

# la dépendance d'abord
ensure ma-bibliotheque

# puis la ressource qui l'utilise
ensure ma-ressource

Les lignes commençant par # sont des commentaires : elles servent à documenter le fichier sans être exécutées. Elles permettent aussi de désactiver temporairement une ressource sans supprimer sa ligne.

Charger la ressource et contrôler la console

Deux commandes suffisent, à saisir dans la console du serveur :

refresh
ensure ma-ressource

refresh relit le dossier resources/ et charge les manifestes qui s’y trouvent, ce qui rend les nouveaux dossiers disponibles au démarrage. ensure enchaîne en lançant celle qui vous intéresse. Vous évitez ainsi de couper la partie en cours. Si vous préférez repartir sur une base propre, un redémarrage complet du serveur relit server.cfg et produit le même résultat.

Surveillez la console pendant le chargement. Un avertissement du type ma-ressource does not have a resource manifest (fxmanifest.lua) signifie que le dossier envoyé ne contient pas de manifeste à sa racine, ce qui correspond typiquement au cas du dossier imbriqué. Une fois la ressource démarrée sans erreur, rejoignez le serveur et testez la fonctionnalité concernée : commande de chat, menu, véhicule ou zone de la carte selon le script installé.

Quand la ressource refuse de démarrer

• Aucun manifeste détecté : un niveau de dossier en trop, ou un fichier nommé autrement que fxmanifest.lua.
• Manifeste signalé comme déprécié : la ressource utilise l’ancien __resource.lua. La documentation indique qu’il peut être renommé en fxmanifest.lua, à condition d’en adapter le contenu.
• Ressource introuvable : nom mal orthographié dans server.cfg, ou casse différente de celle du dossier sous Linux.
• Erreur liée à une dépendance : la bibliothèque requise est absente, ou déclarée après la ressource dans server.cfg.
• Rien ne change après le téléversement : refresh n’a pas été exécuté, ou le fichier modifié n’est pas celui que le serveur lit réellement au démarrage.

Cette procédure suppose un accès direct aux fichiers du serveur et à sa console. Les offres GTA V / FiveM de Koinswift démarrent à 8,99 € par mois pour 6 Go de RAM et donnent accès au gestionnaire de fichiers du Panel Koinswift, aux sauvegardes et à la sélection de version, sur une infrastructure réseau sécurisée et filtrée. Le support reste joignable 7 j/7 si un chargement de ressource pose problème.

Pour aller plus loin

• Introduction to Resources — la page de référence sur le dossier resources/, les catégories entre crochets et le rôle du manifeste.
• Server Commands — la liste complète des commandes serveur, dont start, stop, ensure, restart et refresh.
• Finding Resources — où chercher des ressources et quelles précautions prendre avant de télécharger.
• Installer un serveur FiveM pour GTA V — la mise en place complète du serveur, à faire avant d’ajouter des ressources.