Véhicule addon FiveM qui n'apparaît pas ? Erreurs courantes et détection

Vous avez ajouté un véhicule, redémarré, tapé son nom de spawn, et rien. Ou il apparaît sans textures, ou il roule exactement comme un autre véhicule. Un véhicule addon, ce sont quelques fichiers qui doivent se désigner les uns les autres par leur nom, et un seul nom faux suffit à tout casser.

De quoi est fait un véhicule addon

• stream/ : le modèle (<name>.yft, et <name>_hi.yft pour le voir de près) et ses textures (<name>.ytd).
• Les metas : vehicles.meta (le véhicule lui-même), handling.meta, carvariations.meta (couleurs, kits, livery) et souvent carcols.meta (sirènes, feux, kits de modification).
• Le fxmanifest, qui liste les metas dans files et charge chacun avec sa ligne data_file.

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

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

Les erreurs courantes

• Pas de fxmanifest.lua (ni ancien __resource.lua, ou il s'appelle .off) : FiveM ne charge pas du tout le dossier.
• Une ligne data_file qui pointe vers un fichier absent, ou un meta du dossier qu'aucun data_file ne charge.
• Pas de bloc files { } : les metas doivent y figurer, sinon les joueurs ne les recevront peut-être jamais.
• Un modelName qui ne correspond pas au .yft. Le nom de spawn est le nom du modèle ; un fichier au nom différent n'est jamais trouvé.
• Un txdName qui ne correspond pas au .ytd : le véhicule apparaît sans texture.
• Un handlingId qui n'existe dans aucun handling.meta, ni celui du pack ni celui du jeu.
• Un ID de sirène ou un nom de kit de modification dans carvariations.meta que rien ne définit : pas de sirènes, ou pas de pièces de tuning.
• Deux fichiers du même nom dans le dossier stream : un seul est utilisé.

Les noms de plus de 11 caractères sont un autre piège : le jeu tronque là un gameName, et certains scripts font de même avec le nom du modèle.

Le trouver en quelques secondes

Déposez le dossier de ressource du véhicule dans Vehicle Pack Check. Il fonctionne dans votre navigateur (rien n'est envoyé), vérifie tout ce qui précède par rapport aux handlings, sirènes et kits de modification du jeu, puis liste ce qu'il a trouvé, les erreurs en premier : « No fxmanifest.lua », « <model>.yft is not in the folder », « Its textures, <txd>.ytd, are not in the folder », « handlingId X is in no handling.meta here or in the game »…

Les erreurs empêchent un véhicule de charger ou de fonctionner : corrigez-les d'abord. Les avertissements concernent ce qui fonctionne mais paraît mal, comme un _hi.yft manquant (le véhicule utilise alors son modèle normal de près) ou un fichier diffusé de plus de 16 Mo.

Vous n'avez que le .yft et le .ytd ?

Si le véhicule est arrivé sous forme de .yft et .ytd seuls, sans metas, Vehicle Addon Builder les écrit. Déposez le modèle, choisissez le véhicule du jeu le plus proche comme gabarit (suggéré d'après la taille, les roues et le type), définissez son nom de spawn (11 caractères au plus) et le nom affiché en jeu, ajustez si vous le souhaitez la masse, la vitesse, le freinage et l'adhérence, puis téléchargez une ressource prête avec les metas, les lignes data_file et un README. Il contrôle aussi le modèle : pas de siège pour le conducteur, pas de collision, roues invisibles.

Faites ensuite ensure, redémarrez, et faites apparaître le véhicule par son nom de spawn (avec la commande de votre framework, comme /car <name> sur ESX, ou depuis txAdmin).

Questions

Il apparaît mais sans textures. Pourquoi ?

Son txdName dans vehicles.meta ne correspond à aucun .ytd du dossier stream. Pour les parties qui restent blanches, voir pourquoi les textures FiveM sont blanches ou violettes.

Ai-je besoin de carcols.meta ?

Seulement pour les sirènes, feux ou kits de modification propres au véhicule. Sans lui, le véhicule utilise ce que pointe son carvariations.meta.

L'outil pour cela

Vehicle Pack Check

Déposez le dossier de ressource de votre véhicule : metas manquants, noms erronés et erreurs de stream, les erreurs en premier, avec ce qu'il faut corriger.

Ouvrir Vehicle Pack Check

Aussi utile ici: Vehicle Addon Builder