Ajouter des véhicules custom à votre serveur FiveM

Les véhicules custom sont la première chose qui attire l'attention sur la plupart des serveurs FiveM. Il existe deux types : les mods replace qui remplacent un véhicule GTA existant, et les mods addon qui ajoutent un nouveau véhicule en plus des existants. L'addon est la norme sur les serveurs RP car vous conservez le véhicule GTA original.

Ce dont vous avez besoin

Un mod de véhicule, téléchargé depuis GTA5-Mods ou le forum Releases de cfx.re. Cherchez les mods marqués « FiveM ready » ; ils ont la bonne structure de dossiers et un fxmanifest.lua.
Un accès SFTP à votre serveur (plus rapide que le panneau web pour beaucoup de fichiers).

Structure de dossier d'un véhicule addon

Un véhicule FiveM correctement structuré ressemble à ceci :

resources/[vehicules]/ma-voiture/
    fxmanifest.lua
    stream/
        ma-voiture.yft       (le modèle 3D)
        ma-voiture_hi.yft    (modèle haute qualité)
        ma-voiture.ytd       (textures)
        vehicles.meta       (propriétés du véhicule)
        handling.meta       (comportement de conduite)
        carvariations.meta  (couleurs et pièces)
        carcols.meta        (lumières et sirènes)

Le fxmanifest.lua contient au minimum :

fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
files { 'stream/**/*.meta' }
data_file 'HANDLING_FILE' 'stream/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'stream/vehicles.meta'
data_file 'CARCOLS_FILE' 'stream/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'stream/carvariations.meta'

Installation étape par étape

Arrêtez le serveur.
Envoyez le dossier du véhicule dans resources/[vehicules]/. Les crochets dans le nom du dossier sont une convention FiveM pour la catégorisation.
Ouvrez server.cfg et ajoutez : ensure ma-voiture (le nom du dossier du véhicule).
Démarrez le serveur.
Rejoignez le serveur et faites apparaître le véhicule avec /car nomspawn (le nom depuis vehicles.meta).

Faire apparaître via vMenu ou votre framework

Sur un serveur freeroam avec vMenu, le véhicule apparaît automatiquement dans la liste des véhicules s'il est correctement installé. Sur un serveur RP avec ESX ou Qbox, vous ajoutez le véhicule à la base de données du concessionnaire ou à la configuration du garage, pour que les joueurs puissent l'acheter via l'économie.

Optimiser les textures

Les fichiers YTD non optimisés sont la plus grande cause de problèmes de FPS sur les serveurs FiveM. Beaucoup de véhicules custom sont livrés avec des textures 4096px, alors que FiveM limite en interne à 1024px. Compressez les YTD à 1024px avant de les envoyer. Des outils comme OpenIV font cela. Un serveur avec 200 véhicules ayant chacun 20 Mo de textures envoie 4 Go de données à chaque client ; après optimisation, c'est 800 Mo.

Problèmes courants

Le véhicule n'apparaît pas. Vérifiez que le nom du dossier correspond exactement à la ligne dans server.cfg et que fxmanifest.lua est présent.
Le véhicule est invisible. Le fichier YFT manque ou le nom dans vehicles.meta ne correspond pas au nom du fichier.
Les textures sont incorrectes. Le nom du fichier YTD doit correspondre exactement au nom du modèle.
Saccade du serveur au chargement. Trop de véhicules en même temps, ou des textures non compressées. Voir résoudre les hitch warnings.

Combien de véhicules mon serveur peut-il supporter ?

Avec des textures optimisées : des centaines. Sans optimisation : chaque véhicule coûte de la mémoire et de la bande passante. Règle générale : 100 véhicules optimisés sur un serveur 8 Go est confortable.

Dois-je utiliser replace ou addon ?

Addon pour les serveurs RP, afin que le véhicule original reste disponible. Replace uniquement si vous voulez remplacer tous les véhicules GTA et avoir une offre de véhicules strictement contrôlée.

Les joueurs doivent-ils aussi télécharger les véhicules ?

Non. FiveM envoie automatiquement les fichiers au client lors de la connexion. Cela coûte de la bande passante et du temps de chargement, mais le joueur n'a rien à installer manuellement.

Les véhicules tournent sur tous les packs FiveM. Pour les serveurs avec beaucoup d'assets custom, nous recommandons 8 Go ou plus.