Comment ajouter des voitures et des scripts sur FiveM

Un serveur FiveM n'est au fond qu'une pile de resources : des scripts, des voitures, des maps et des jobs qui vivent chacun dans leur dossier et que l'on active dans server.cfg. Ce guide explique comment les resources sont structurées, comment installer un script proprement, et comment ajouter des véhicules add-on en stream sur un serveur FiveM DoomHosting sans casser votre ordre de démarrage.

Où vont les resources sur un serveur FiveM ?

Tout se trouve au même endroit : le dossier resources. Ouvrez l'onglet Fichiers dans le panneau et entrez dans resources. Chaque script, voiture ou map est un sous-dossier à part, avec un fxmanifest.lua dedans.

Les dossiers entre crochets comme [cars] ou [esx] ne sont que des dossiers de regroupement. FiveM charge automatiquement toutes les resources contenues dans un dossier à crochets, ce qui est une façon propre de garder tous vos véhicules ou toutes vos resources de framework ensemble. Un dossier à crochets ne peut pas en contenir un autre, et il ne doit pas contenir de fichiers en vrac, uniquement des sous-dossiers de resources.

Comment installer un script sur un serveur FiveM ?

1. Téléchargez le script. Les resources de qualité viennent des releases officielles du forum Cfx.re et de dépôts GitHub sérieux.

2. Dans l'onglet Fichiers, ouvrez resources et envoyez-y le dossier du script. Pour les gros envois, passez par le SFTP (les identifiants sont derrière le bouton SFTP de l'onglet Fichiers) plutôt que par l'uploader du navigateur.

3. Lisez le README du script pour connaître ses dépendances. La plupart ont besoin d'un framework (es_extended ou qb-core) et souvent d'oxmysql déjà démarré.

4. Ajoutez une ligne ensure dans server.cfg, après ses dépendances :

   ensure oxmysql
   ensure es_extended
   ensure your-new-script
   

   

5. Redémarrez le serveur et surveillez l'onglet Console : le démarrage doit être propre, sans erreur en rouge.

Faut-il utiliser start ou ensure dans server.cfg ?

Utilisez ensure. Il démarre la resource si elle est arrêtée et la redémarre si elle tourne déjà, ce qui est exactement le comportement voulu au boot. start se contente de démarrer une resource, c'est l'ancienne syntaxe. Aucune raison de mélanger les deux : mettez ensure sur toutes les lignes de votre config.

Comment ajouter une voiture personnalisée sur un serveur FiveM ?

Les véhicules add-on sont des resources "streamées" : les fichiers de modèle sont envoyés aux joueurs quand ils se connectent. C'est la structure des dossiers qui compte.

1. Créez un dossier de resource pour la voiture (ou déposez-la dans votre dossier de groupe [cars]), par exemple resources/[cars]/police_charger.

2. Dedans, placez les fichiers de modèle du véhicule (.yft, .ytd) dans un sous-dossier stream, et les fichiers de métadonnées (vehicles.meta, carvariations.meta, handling.meta, etc.) à côté d'un fxmanifest.lua :

   police_charger/
     fxmanifest.lua
     stream/
       police_charger.yft
       police_charger.ytd
     vehicles.meta
     carvariations.meta
     handling.meta
   

3. Le fxmanifest.lua indique à FiveM de streamer le modèle et de charger les fichiers meta :

   fx_version 'cerulean'
   game 'gta5'
   
   files {
     'vehicles.meta',
     'carvariations.meta',
     'handling.meta'
   }
   
   data_file 'VEHICLE_METADATA_FILE' 'vehicles.meta'
   data_file 'CARCOLS_FILE' 'carvariations.meta'
   data_file 'HANDLING_FILE' 'handling.meta'
   

4. Ajoutez ensure police_charger dans server.cfg, redémarrez, et le nom de spawn défini dans vehicles.meta devient utilisable en jeu.

La plupart des voitures que vous téléchargez contiennent déjà un fxmanifest.lua fonctionnel et les bons dossiers : en pratique, vous envoyez le dossier et vous ajoutez une ligne ensure. Ne construisez la structure à la main que si la voiture est livrée en fichiers en vrac.

Faut-il faire correspondre l'artifact ou le gamebuild FiveM ?

Parfois. Deux réglages de version décident si une resource se charge ou non :

• Artifact (version du serveur) : défini par la variable fivem version dans l'onglet Démarrage du panneau. Laissez-la sur recommended sauf si un script précis exige un build plus récent.
• Gamebuild : certains véhicules et MLO récents demandent un build de jeu spécifique. Définissez-le dans server.cfg avec, par exemple, sv_enforceGameBuild 2802. Si une voiture ou une map est invisible ou fait planter les joueurs au spawn, un gamebuild mal aligné en est une cause fréquente.

Ne montez ces valeurs que si une resource le demande explicitement. Forcer un gamebuild plus élevé que ce que vos resources supportent crée souvent plus de problèmes que ça n'en résout.

Erreurs courantes

• La resource ne démarre pas : le nom du dossier doit correspondre exactement à la ligne ensure, et fxmanifest.lua doit se trouver directement dans le dossier de la resource, pas un niveau plus bas. Le dossier dans un dossier est la cause numéro un.
• Failed to load sur un modèle streamé : les fichiers de modèle ne sont pas dans un dossier stream, ou les noms .yft et .ytd ne correspondent pas à ce que référencent les fichiers meta.
• Dépendance manquante : la console nomme l'export ou la resource qui manque. Ajoutez sa ligne ensure au-dessus de la resource en échec.
• La voiture apparaît mais roule mal ou reste invisible : un handling.meta ou un vehicles.meta manquant ou mal aligné, ou un gamebuild qui ne correspond pas.

Un mot sur l'endroit où vous téléchargez vos resources

Restez sur le forum officiel des releases Cfx.re et sur les pages GitHub des développeurs d'origine. Les copies leakées ou "gratuites" de resources payantes sont le premier moyen par lequel les serveurs FiveM se font backdoorer, ce qui peut faire fuiter votre base de données ou donner le contrôle de votre serveur. Si une resource est obfusquée ou vient d'un Discord au hasard, ne la lancez pas.

Étapes suivantes

Pour brancher vos voitures et vos scripts sur une vraie base roleplay, commencez par installer ESX ou QBCore sur votre serveur FiveM. Pour un tableau de bord web qui gère les resources et les redémarrages, mettez en place txAdmin sur votre serveur FiveM.

Nouveau ici ? Découvrez l'hébergement de serveurs FiveM ou le panneau de contrôle de jeu.