Ajouter des véhicules (addon cars)

Les véhicules « addon » s’installent comme une ressource qui streame les modèles 3D et leurs métadonnées vers les clients. Une mauvaise structure de dossiers ou un dlctext manquant empêchent les voitures d’apparaître en jeu.

Cause / Le problème

Les véhicules personnalisés ne s’affichent pas quand le .rpf n’est pas streamé, que les fichiers meta (carcols, carvariations, handling, vehicleslod) sont absents ou mal déclarés, ou que deux packs utilisent le même nom de modèle. Le jeu charge alors un véhicule vanilla ou le transforme en « erreur de chargement ».

Solution

1. Créez un dossier ressource, par exemple resources/[cars]/mes_voitures/, avec un fichier fxmanifest.lua :

   fx_version 'cerulean'
   game 'gta5'
   
   files {
       'stream/**/*.yft',
       'stream/**/*.ytd',
       'stream/**/*.meta',
   }
   
   data_file 'VEHICLES_METADATA_FILE' 'stream/**/vehicles.meta'
   data_file 'CARCOLS_FILE'           'stream/**/carcols.meta'
   data_file 'CARVARIATIONS_FILE'     'stream/**/carvariations.meta'
   data_file 'HANDLING_FILE'          'stream/**/handling.meta'
   data_file 'VEHICLE_LAYOUTS_FILE'   'stream/**/vehiclelayouts.meta'

2. Placez les modèles (.rpf, .yft, .ytd) et les .meta dans le dossier stream/. Conservez la hiérarchie fournie par l’auteur du pack.
3. Déclarez la ressource dans server.cfg :

   ensure mes_voitures

4. Ajoutez le nom du DLC dans un dlctext.meta si le pack l’exige, sinon le modèle ne sera pas reconnu par le spawn menu (/car adder2023).
5. Évitez les doublons : deux ressources qui streament le même vehicle name provoquent des conflits et des chutes de FPS. Gardez un seul exemplaire de chaque modèle.
6. Redémarrez le serveur et, côté client, vérifiez le cache citizen/common/data : un clear_cache dans txAdmin résout les modèles invisibles après un changement.

Côté client, les fichiers se téléchargent automatiquement à la connexion. Si une voiture reste invisible, le problème vient presque toujours d’un meta manquant, pas du modèle lui-même.