Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

FiveM

Comment ajouter des véhicules add-on à un serveur FiveM (fxmanifest et stream)

26 août 2026 13 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous apprendrez à ajouter de A à Z un véhicule add-on à votre serveur FiveM : la structure du dossier de ressource, les fichiers à placer dans les dossiers stream et data, la rédaction du fichier fxmanifest.lua et le lancement du véhicule via server.cfg. À la fin, vous saurez aussi déterminer par vous-même pourquoi un véhicule n'apparaît pas en jeu ou pourquoi il fait planter le jeu.

Avant de commencer

  • Une installation de FXServer fonctionnelle. Si vous n'en avez pas encore, suivez d'abord le guide d'installation de FXServer. La clé de licence ne s'obtient plus sur Keymaster, mais sur le Cfx.re Portal (portal.cfx.re).
  • Un accès aux fichiers du serveur : vous vous connectez à un VDS Windows en RDP (3389) et à un VDS Linux en SSH (22). Pour envoyer des fichiers sous Linux, utilisez un client SFTP comme WinSCP.
  • Un pack de véhicule add-on compatible avec FiveM. Le pack contient généralement des fichiers .yft et .ytd dans un dossier stream, ainsi que quelques fichiers .meta. Si le pack a été conçu comme un « replace », il ne fonctionnera pas avec la méthode de ce guide ; nous expliquons la différence à la première étape.
  • Un éditeur de texte (Notepad++, VS Code, nano). Le Bloc-notes de Windows convient aussi, mais lors de l'enregistrement, vérifiez que l'extension du fichier n'est pas .txt.
  • Une commande pour faire apparaître le véhicule en jeu : un menu d'administration comme vMenu, ou le petit script de test de l'étape six.

1. Comprendre la différence entre replace et add-on

Il existe deux façons d'ajouter un véhicule moddé à GTA V. Un replace prend la place des fichiers de modèle d'un véhicule qui existe déjà dans le jeu (par exemple adder) : le véhicule d'origine disparaît, le nom de spawn (le nom utilisé pour le faire apparaître en jeu) reste le même et, sauf si vous les modifiez séparément, ce sont les valeurs de handling (physique de conduite) du véhicule d'origine qui s'appliquent. Un add-on, en revanche, définit un véhicule entièrement nouveau dans le jeu : il a son propre nom de spawn, sa propre entrée de handling et ses propres définitions de couleurs et de tuning ; aucun véhicule d'origine n'est supprimé.

CaractéristiqueReplaceAdd-on
Véhicule d'origineDisparaîtConservé
Nom de spawnLe nom du véhicule d'origineLe nouveau nom défini par le pack
Fichiers nécessairesContenu de stream et un fxmanifest.lua minimalstream, fichiers .meta et lignes data_file dans un fxmanifest.lua
HandlingL'entrée d'origine est utiliséeUne entrée propre au pack
Nombre de véhiculesAutant que vous en remplacezChaque pack ajoute un nouveau modèle
Idéal pourRemplacer volontairement un véhicule précisAjouter de nouveaux véhicules au serveur

Pour les propriétaires de serveur, l'add-on est généralement la bonne méthode. Les packs replace modifient des véhicules auxquels les joueurs sont habitués et, lorsque deux packs replace visent le même véhicule, l'un écrase l'autre.

2. Créez le dossier de ressource

FXServer considère chaque dossier situé sous resources/, dans le dossier de données de votre serveur, comme une ressource. Les dossiers entre crochets (comme [cars]) comptent comme des catégories et peuvent contenir plusieurs ressources. Regrouper les véhicules dans leur propre catégorie permet de rester organisé lorsque vous en avez des dizaines. Dans l'installation officielle, le dossier de données du serveur est C:\FXServer\server-data sous Windows et ~/FXServer/server-data sous Linux ; si vous avez installé le serveur avec une recette txAdmin, utilisez le dossier du serveur créé par txAdmin.

server-data/
└── resources/
    └── [cars]/
        └── bmwm3/
            ├── fxmanifest.lua
            ├── data/
            │   ├── vehicles.meta
            │   ├── handling.meta
            │   ├── carvariations.meta
            │   └── carcols.meta
            └── stream/
                ├── bmwm3.yft
                ├── bmwm3_hi.yft
                └── bmwm3.ytd

Sous Windows, créez les dossiers avec l'Explorateur de fichiers. Sous Linux, une seule commande suffit ; mettez le nom entre crochets entre guillemets pour que le shell ne l'interprète pas comme un motif :

mkdir -p ~/FXServer/server-data/resources/"[cars]"/bmwm3/{data,stream}

Donnez au dossier un nom en minuscules, sans espaces, sans accents ni caractères spéciaux (é, è, à, ç). Ce nom est aussi le nom de ressource que vous utiliserez dans la commande ensure ; un nom contenant des espaces est lu dans la console comme deux arguments distincts. La documentation officielle vous laisse libre du nommage, mais nous vous recommandons de suivre cette règle pour simplifier la gestion.

3. Remplissez les dossiers stream et data

Placez les fichiers de modèle et de texture du pack dans le dossier stream. Inutile de lister un par un les fichiers de ce dossier dans le manifeste : FXServer les envoie (stream) lui-même aux joueurs. Les types de fichiers que vous rencontrerez :

  • .yft : le modèle 3D du véhicule. Il y a généralement deux fichiers, ad.yft et ad_hi.yft en haute définition, où « ad » désigne le nom du modèle.
  • .ytd : le dictionnaire de textures, c'est-à-dire l'habillage du véhicule.
  • Certains packs incluent des fichiers .yft et .ytd supplémentaires pour les pièces de tuning (par exemple bmwm3_mods.ytd) ; ils vont aussi dans stream.

Placez les fichiers .meta dans le dossier data. Ils peuvent aussi se trouver dans le dossier racine ; l'essentiel est que le chemin indiqué dans le manifeste corresponde exactement au chemin réel. Chaque fichier a un rôle différent :

  • vehicles.meta : enregistre le véhicule dans le jeu. La valeur <modelName> qu'il contient est le nom de spawn ; <handlingId> renvoie à l'entrée de handling.meta.
  • handling.meta : la physique de conduite, comme la masse, la puissance du moteur, les freins et la suspension. La valeur <handlingName> de ce fichier doit correspondre exactement à ce que vehicles.meta indique comme handlingId.
  • carvariations.meta : les combinaisons de couleurs d'usine et le kit de tuning (<kits>) utilisé par le véhicule.
  • carcols.meta : les kits de tuning ainsi que les réglages des sirènes et des feux. Le nom du kit doit correspondre à la référence de carvariations.meta.
  • vehiclelayouts.meta (absent de certains packs) : les animations d'assise et d'entrée ; il accompagne les véhicules dotés d'un habitacle personnalisé.

4. Écrivez le fichier fxmanifest.lua

Créez un fichier nommé fxmanifest.lua dans le dossier racine de la ressource. Ce fichier indique à FXServer à quel type de données de jeu appartient chaque fichier .meta. D'après la documentation officielle du manifeste, la version actuelle du manifeste est cerulean, et la valeur de jeu pour FiveM est gta5.

fx_version 'cerulean'
game 'gta5'

files {
    'data/vehicles.meta',
    'data/handling.meta',
    'data/carvariations.meta',
    'data/carcols.meta'
}

data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'

Les deux sections sont indispensables : files ajoute les fichiers au paquet que téléchargent les joueurs, et data_file indique au système de contenu supplémentaire du jeu sous quel type charger chaque fichier. Si vous n'écrivez que files, le fichier est téléchargé, mais le jeu ne le charge pas comme donnée ; si vous n'écrivez que data_file, le jeu cherche un fichier qui n'a jamais été téléchargé. data_file accepte les caractères génériques (*) : 'data/*_handling.meta' charge tous les fichiers du dossier data dont le nom se termine par _handling.meta ; comme dans l'exemple officiel, indiquez aussi le même chemin dans files.

Sous Linux, les noms de fichiers sont sensibles à la casse : si vous écrivez Handling.meta dans le manifeste alors que le fichier s'appelle handling.meta, le fichier ne sera pas trouvé. Le plus simple est d'écrire tous les noms de fichiers et de dossiers en minuscules.

Si le pack est fourni avec un son de moteur personnalisé (fichiers .awc et .rel), le manifeste doit aussi contenir des lignes pour l'audio ; dans la liste officielle des fichiers de données, il s'agit des types AUDIO_WAVEPACK, AUDIO_SOUNDDATA et AUDIO_GAMEDATA. Si le pack est livré avec un manifeste prêt à l'emploi, utilisez-le en priorité ; vérifiez simplement que les chemins de ses lignes correspondent aux chemins réels des fichiers.

5. Ajoutez la ligne ensure au fichier server.cfg et actualisez le serveur

Ouvrez le fichier server.cfg et ajoutez le nom de la ressource à côté des autres lignes ensure :

ensure bmwm3

D'après la documentation officielle des commandes, ensure redémarre une ressource si elle tourne, la démarre si elle ne tourne pas, et accepte aussi un nom de catégorie. Vous pouvez donc également démarrer tous les véhicules d'une catégorie avec une seule ligne : ensure [cars].

Pour mettre la nouvelle ressource en service sans arrêter le serveur, tapez ces deux commandes dans la console du serveur (ou dans la console txAdmin) :

refresh
ensure bmwm3

refresh analyse à nouveau le dossier resources et lit les manifestes ; ensure démarre ensuite la ressource. Vous devriez voir la ligne Started resource bmwm3 dans la console. Si un joueur connecté à ce moment-là ne voit pas le véhicule, il suffit généralement qu'il quitte le jeu et se reconnecte.

6. Trouvez le nom de spawn et testez le véhicule

Le nom de spawn n'est pas le nom du dossier ; c'est la valeur que vehicles.meta contient dans <modelName>, et il correspond généralement au nom du fichier de modèle du dossier stream (le fichier .yft). Le nom affiché sur la page du pack et celui du fichier diffèrent parfois ; ouvrez donc le fichier pour vérifier :

<modelName>bmwm3</modelName>
<txdName>bmwm3</txdName>
<handlingId>BMWM3</handlingId>

FiveM n'a pas de commande /car intégrée ; elle est fournie par un menu d'administration comme vMenu ou par un script. Si vous n'avez pas de menu, utilisez une version simplifiée de l'exemple d'apparition de véhicule de la documentation officielle « first script » (premier script). Créez un dossier resources/aractest/ et placez-y deux fichiers. fxmanifest.lua :

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

client.lua :

RegisterCommand('car', function(source, args)
    local vehicleName = args[1] or 'adder'

    if not IsModelInCdimage(vehicleName) or not IsModelAVehicle(vehicleName) then
        print('Model yok: ' .. vehicleName)
        return
    end

    RequestModel(vehicleName)
    while not HasModelLoaded(vehicleName) do
        Wait(500)
    end

    local playerPed = PlayerPedId()
    local pos = GetEntityCoords(playerPed)
    local vehicle = CreateVehicle(vehicleName, pos.x, pos.y, pos.z, GetEntityHeading(playerPed), true, false)
    SetPedIntoVehicle(playerPed, vehicle, -1)
    SetEntityAsNoLongerNeeded(vehicle)
    SetModelAsNoLongerNeeded(vehicleName)
end, false)

Tapez refresh et ensure aractest dans la console, puis tapez /car bmwm3 dans le chat du jeu. Si le modèle est introuvable, un avertissement apparaît dans la console F8 ; cela indique que le problème se situe du côté de stream ou des fichiers .meta. Le false de la dernière ligne rend la commande accessible à tout le monde ; n'utilisez ce script que pour vos tests et retirez-le de votre serveur en production. Si le véhicule apparaît, testez tour à tour ses couleurs, son tuning (LS Customs) et sa conduite ; chacun de ces tests vérifie un fichier .meta différent.

Exemple de configuration : types de data_file

Le tableau ci-dessous résume les types de la liste officielle des fichiers de données que vous rencontrerez dans les packs de véhicules, ainsi que le fichier que chacun définit.

Type de data_fileFichierCe qu'il définitConséquence s'il manque
VEHICLE_METADATA_FILEvehicles.metaEnregistrement du véhicule, nom de spawn, classeLe véhicule n'est pas reconnu du tout
HANDLING_FILEhandling.metaPhysique de conduiteLe véhicule n'apparaît pas ou le jeu plante
VEHICLE_VARIATION_FILEcarvariations.metaOptions de couleur, lien vers le kitUne seule couleur, pas de tuning
CARCOLS_FILEcarcols.metaKits de tuning, sirènes et feuxAucune pièce dans LS Customs
VEHICLE_LAYOUTS_FILEvehiclelayouts.metaAnimations d'entrée et d'assiseProblèmes pour monter dans un véhicule qui dépend d'un agencement personnalisé
AUDIO_WAVEPACKLe dossier des fichiers .awcPack d'ondes sonores du moteur personnaliséSon absent ou son par défaut
AUDIO_GAMEDATA*.dat151.relDéfinition du sonLe son ne se charge pas

Erreurs fréquentes

  • Le véhicule n'apparaît pas et vous obtenez l'avertissement « Model yok » (modèle introuvable). Vous avez peut-être mal saisi le nom de spawn ; ouvrez vehicles.meta et comparez son modelName au nom du fichier .yft. La ressource a-t-elle vraiment démarré ? Tapez ensure bmwm3 dans la console et lisez la sortie ; si vous voyez Couldn't find resource bmwm3., le nom du dossier est incorrect ou le refresh manque.
  • Le véhicule apparaît, mais il est tout blanc ou sans textures. Le fichier .ytd n'est pas dans le dossier stream, ou son nom ne correspond pas à celui que vehicles.meta indique comme txdName.
  • Le jeu plante lorsque vous faites apparaître le véhicule ou que vous montez dedans. Le plus souvent, handling.meta n'a pas été chargé, ou handlingId et handlingName ne correspondent pas. Deuxième cause possible : le pack dépend d'un contenu DLC plus récent que la version (build) du jeu utilisée par votre serveur. Dans server.cfg, choisissez un build plus récent avec sv_enforceGameBuild (par exemple sv_enforceGameBuild 3407). Ce réglage n'est lu qu'au démarrage ; redémarrez complètement le serveur.
  • Le véhicule glisse, s'envole ou ne prend pas de vitesse. Les valeurs de handling sont incorrectes. Comparez le fichier handling.meta du pack avec les valeurs d'un véhicule d'origine similaire ; fMass, fInitialDriveForce et fTractionCurveMax sont les champs le plus souvent mal réglés.
  • Deux véhicules se remplacent l'un l'autre, ou l'un d'eux disparaît. Les deux packs utilisent le même modelName, le même handlingName ou le même nom de kit. Donnez à l'un des deux un nom unique et modifiez ce nom dans tous les fichiers où il apparaît.
  • Les joueurs attendent longtemps lors de la connexion. Les packs de véhicules très détaillés (high-poly) peuvent peser des dizaines de mégaoctets, et ils sont téléchargés pendant la connexion. Retirez du pack les textures inutilisées et les fichiers superflus ; pour plus de détails, consultez le guide d'optimisation.
  • La ressource ne démarre pas. Si vous voyez Couldn't start resource ou une erreur de manifeste dans la console, vérifiez la syntaxe de fxmanifest.lua ; cherchez un guillemet ou une virgule manquants. Les anciens packs sont fournis avec __resource.lua : renommez le fichier en fxmanifest.lua, supprimez la ligne resource_manifest_version et ajoutez les lignes fx_version et game.

Questions fréquentes

Puis-je mettre plusieurs véhicules dans une seule ressource ?

Oui. Placez tous les fichiers .yft et .ytd dans le même dossier stream ; ensuite, soit vous regroupez à la suite les entrées de chaque véhicule dans le fichier .meta concerné, soit vous chargez des fichiers séparés avec un chemin générique comme data_file 'HANDLING_FILE' 'data/*_handling.meta'. Comme cela facilite le débogage, nous vous recommandons de garder au début chaque véhicule dans une ressource distincte.

Peut-on convertir un pack replace en add-on ?

Les fichiers de modèle et de texture sont les mêmes ; ce qui manque, ce sont les définitions .meta. Vous pouvez le transformer en add-on en reprenant les entrées vehicles.meta, handling.meta et carvariations.meta de l'équivalent d'origine du véhicule et en changeant le nom du modèle. C'est un travail avancé ; si possible, cherchez plutôt la version add-on.

À quoi sert le dossier stream_enhanced ?

C'est un dossier de ressources graphiques distinct, destiné à FiveM pour GTAV Enhanced (le client de nouvelle génération). D'après la documentation officielle, si stream_enhanced existe, le client Enhanced l'utilise ; sinon, il utilise le dossier stream classique. Sur les serveurs qui accueillent les deux clients, placez les fichiers Gen8 dans stream et les fichiers Gen9 dans stream_enhanced.

Comment ajouter le véhicule au concessionnaire ?

Cela dépend de votre framework. Dans QBCore, un véhicule s'ajoute au fichier qb-core/shared/vehicles.lua avec des champs comme model, name, price, category et shop ; le champ model correspond au nom de spawn. Dans ESX, la liste dépend de la ressource de concessionnaire que vous utilisez et se trouve généralement dans une table de la base de données. Pour modifier la base de données, consultez le guide HeidiSQL.

Quel serveur suffit pour des véhicules add-on ?

Les packs de véhicules sollicitent davantage le disque et la bande passante du serveur que son CPU ; les fichiers sont téléchargés par les joueurs lorsqu'ils se connectent. La gamme VDS Ryzen 9 9950X, fournie avec des disques NVMe et une connexion 1 Gbit/s, est l'option que nous recommandons pour FiveM ; vous pouvez voir les offres sur la page Location de serveur FiveM.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.