Formats de fichiers GTA V et FiveM, en clair

GTA V fonctionne avec RAGE, Rockstar Advanced Game Engine. FiveM conserve ce système de Fichiers et diffuse des Fichiers et des métadonnées supplémentaires dans le jeu.

La plupart des fichiers de serveur sont liés à un autre fichier. Un fichier .ytd fournit des textures à un modèle. Un fichier .ytyp indique au jeu ce qu'est un prop. Un fichier .meta indique au jeu comment un véhicule, une arme, une ligne de comportement ou un autre système doit fonctionner. Une fois ces liens compris, les ressources défectueuses sont plus faciles à corriger.

Aperçu rapide des formats

Comment les fichiers se connectent

.ydr plus .ytd plus .ytyp

Un prop commence généralement par un .ydr. Le .ydr contient le mesh et les références de matériaux. Le .ytd contient les noms de textures demandés par ces matériaux. Le .ytyp définit le prop comme un archétype afin que les placements sur la carte sachent de quoi il s’agit.

Si le modèle apparaît blanc, gris ou invisible, vérifier d’abord le dictionnaire de textures. Le nom de texture dans le .ytd doit correspondre au nom attendu par le modèle. Si le prop existe mais ne se place pas correctement sur une carte, vérifier le .ytyp.

.yft plus les métadonnées du véhicule

Un .yft est généralement le modèle de véhicule dans une ressource FiveM. De nombreux véhicules ont aussi une version _hi.yft avec davantage de détails à courte distance. Les textures se trouvent dans un .ytd et le comportement provient des fichiers de métadonnées.

• vehicles.meta relie le nom du modèle, la classe du véhicule, la configuration, l’audio et d’autres paramètres du véhicule.
• handling.meta contrôle le comportement de conduite.
• carvariations.meta relie les livrées, les couleurs, les extras et les données de variation.
• carcols.meta contient souvent des données supplémentaires sur les couleurs et les kits de modifications.

.ydd plus .ytd

Un .ydd est un dictionnaire de drawables. Dans la plupart des discussions entre propriétaires de serveurs, cela désigne les Vêtements. La géométrie se trouve dans le .ydd et les textures correspondantes dans le .ytd. Si un vêtement se charge avec le mauvais tissu ou un matériau vide, vérifier les noms de textures et des composants avant de reconstruire toute la ressource.

.xml est généralement la copie modifiable

Des outils comme CodeWalker exportent souvent les fichiers .ydr, .yft et d’autres fichiers du jeu au format .xml. Ce XML est plus facile à inspecter et à modifier, mais le jeu ne stream pas le fichier .xml exporté comme fichier final. Après modification, le compiler ou l’importer à nouveau dans le format du jeu.

Collision .ybn / .ybd

La collision est la partie qui se remarque lorsque le visuel est bon mais que le monde semble incorrect. Un .ybn ou .ybd peut définir la forme physique autour d’un prop, d’un bâtiment, d’une route ou d’un autre élément du monde. Si les joueurs passent à travers un sol, heurtent un mur invisible ou traversent un objet visible en voiture, vérifier la collision avant de reconstruire le modèle.

Dictionnaires d’animations .ycd

Les données d’animation se trouvent généralement dans des fichiers .ycd. De nombreux scripts FiveM appellent les dictionnaires d’animations existants du jeu, mais les Fichiers personnalisés peuvent inclure leurs propres clips d’animation. Si une demande d’animation ne produit aucun effet, vérifier le nom du dictionnaire, le nom du clip, le chemin de la ressource et si le fichier est streamé.

Où se place le manifeste

Les ressources FiveM utilisent fxmanifest.lua pour décrire les scripts, les fichiers de données, les pages d’interface, les dépendances et les fichiers que les clients doivent télécharger. Pour les entrées exactes du manifeste, consulter la documentation officielle des manifestes de ressources.

fx_version 'cerulean'
game 'gta5'

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

data_file 'DLC_ITYP_REQUEST' 'stream/props.ytyp'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'HANDLING_FILE' 'data/handling.meta'

Le manifeste ne corrige pas les mauvais noms dans un modèle. Il indique seulement à FiveM quels fichiers de ressource et métadonnées doivent être chargés. Si le .ydr demande une texture appelée sign_1 et que le .ytd contient uniquement sign1, le manifeste peut être parfait et la texture échouera quand même.

Fichiers source et fichiers du jeu

Les créateurs travaillent aussi avec des fichiers qui ne sont pas des Fichiers finaux streamés. Un .png, .jpg, .psd, .glb, .fbx ou .obj peut être la source utilisée pour créer la ressource, mais GTA V nécessite généralement que le résultat soit empaqueté dans les formats ci-dessus.

Adapter l’outil au fichier

Checklist de débogage rapide

• Le modèle est invisible : vérifier le nom du fichier, le dossier stream, le nom du modèle, ainsi que l’absence éventuelle d’un fichier .ytyp ou de métadonnées.
• Le modèle est blanc ou gris : vérifier le .ytd et les noms des textures attendues par le modèle.
• Le véhicule apparaît, mais n’a aucune livrée : vérifier carvariations.meta et les noms des textures de livrée dans le .ytd.
• Les vêtements apparaissent avec la mauvaise texture : vérifier le nommage des composants et la présence du dictionnaire de textures .ytd correspondant.
• Le prop de map existe, mais ne se place pas correctement : vérifier l’archétype .ytyp et les références .ymap.
• Le fichier fonctionne dans OpenIV ou Codewalker, mais pas sur le serveur : vérifier les entrées fxmanifest.lua data_file et la structure du dossier de la ressource.

Guides associés