Referencia de data_file de fxmanifest para vehículos

La documentación de FiveM describe data_file como algo que añade "a data file of a specified type to the game extra content system", es decir, un archivo de datos de un tipo concreto al sistema de contenido extra del juego. En la práctica es el mismo mecanismo que usa el juego para sus propios packs de DLC: de cada tipo se ocupa un cargador que sabe leer esa clase de archivo.

La línea tiene dos cadenas: el tipo y la ruta dentro del resource.

fx_version 'cerulean'
game 'gta5'

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

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

El archivo también tiene que aparecer en files. files hace que el servidor envíe el archivo a los jugadores, y data_file hace que el juego lo lea. Uno sin el otro no hace nada.

Estos son los tipos que importan para los vehículos, tomados de la referencia de data files de FiveM.

Tipo de data_file	Archivo	Elemento raíz	Para qué sirve
HANDLING_FILE	handling.meta	CHandlingDataMgr	Perfiles de física. Guía
VEHICLE_METADATA_FILE	vehicles.meta	CVehicleModelInfo__InitDataList	Registra los modelos de vehículos. Guía
CARCOLS_FILE	carcols.meta	CVehicleModelInfoVarGlobal	Mod kits, sirenas, luces. Guía
VEHICLE_VARIATION_FILE	carvariations.meta	CVehicleModelInfoVariation	Colores, kits y ajustes de luces por modelo.
VEHICLE_LAYOUTS_FILE	vehiclelayouts.meta	CVehicleMetadataMgr	Asientos, puntos de entrada, animaciones. Guía
CLIP_SETS_FILE	clip_sets.xml	fwClipSetManager	Clip sets para animaciones personalizadas.
EXPLOSION_INFO_FILE	explosion.meta	CExplosionInfoManager	Configuraciones de explosión personalizadas.
VFXVEHICLEINFO_FILE	vfxvehicleinfo.meta		Conjuntos de efectos visuales de vehículos.
PTFXASSETINFO_FILE	ptfxassetinfo.meta		Información de assets de efectos de partículas.
AUDIO_GAMEDATA, AUDIO_SOUNDDATA, AUDIO_WAVEPACK	.dat151.rel, .dat54.rel, carpeta de archivos .awc		Sonidos de motor personalizados.
VEHICLE_SHOP_DLC_FILE	shop_vehicle.meta		Datos de tienda de vehículos de los packs de DLC.
CONTENT_UNLOCKING_META_FILE			Aparece en la referencia sin descripción. No hace falta para un vehículo add-on.

El tipo debe escribirse exactamente igual y en mayúsculas.

En parte. FiveM siempre carga las entradas HANDLING_FILE y VEHICLE_LAYOUTS_FILE antes que cualquier otro tipo, las hayas escrito en el orden que sea. Todos los demás tipos conservan el orden del manifest. Esto sale del código del cliente de FiveM, que ordena la lista de ese modo antes de cargar.

El motivo está en el lado del juego: cuando se lee vehicles.meta, el juego busca por nombre la entrada de handling del vehículo y su layout en ese mismo instante. Si todavía no están cargados, el vehículo se registra sin ellos.

Para los tipos restantes, escríbelos en orden de dependencia, primero lo que otros archivos referencian:

fx_version 'cerulean'
game 'gta5'

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

-- 1. things vehicles.meta points at
data_file 'HANDLING_FILE'          'data/handling.meta'
data_file 'CLIP_SETS_FILE'         'data/clip_sets.xml'
data_file 'VEHICLE_LAYOUTS_FILE'   'data/vehiclelayouts.meta'
-- 2. the vehicle itself
data_file 'VEHICLE_METADATA_FILE'  'data/vehicles.meta'
-- 3. kits, then the variations that reference them
data_file 'CARCOLS_FILE'           'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'

• CLIP_SETS_FILE cerca del principio, ya que los layouts se refieren a los clip sets por nombre.
• VEHICLE_METADATA_FILE a continuación.
• CARCOLS_FILE antes que VEHICLE_VARIATION_FILE, porque carvariations.meta se refiere a kits que define carcols.meta.

Sí. Tanto files como data_file aceptan patrones glob en la ruta. * coincide dentro de una carpeta y ** coincide a cualquier profundidad. Un pack de vehículos con una subcarpeta por vehículo se puede declarar una sola vez:

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

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

Así, los vehículos nuevos que se dejen en data/ se detectan sin editar el manifest.

Los archivos de una carpeta llamada stream se registran automáticamente por nombre de archivo y extensión, así que los modelos, las texturas y los diccionarios de animación no necesitan ninguna entrada en el manifest. Las subcarpetas dentro de stream no dan problemas. Hay dos cosas que FiveM rechaza ahí: los archivos sin extensión y los archivos .rpf, que hay que extraer antes.

Cómo extraer un dlc.rpf de un jugador y ordenar sus archivos en un resource está en cómo convertir un coche de un jugador en add-on FiveM.

Los resources de pago que se entregan mediante Cfx.re Asset Escrow tienen protegidos sus scripts y archivos de modelo, y la entrada del manifest escrow_ignore enumera los archivos que el sistema de escrow deja intactos. Qué archivos quedan abiertos lo decide el autor, así que revisa la página del producto. Los metas que el dueño de un servidor quiere editar más a menudo son:

• handling.meta, para cambiar la velocidad, el agarre y la frenada.
• carvariations.meta, para cambiar las combinaciones de color.
• vehicles.meta, para cambiar los flags, la clase o la clave del nombre mostrado.

En los vehículos de Nilo3D, como el Coil S-Cooter, los metas de handling y de vehículos quedan abiertos. Cómo se instalan los resources con escrow está en instalar un resource de FiveM de Cfx.re Escrow.

Si un resource con escrow no arranca y muestra "You lack the required entitlement", mira cómo solucionar el error de entitlement.

Error	Resultado	Solución
Meta en data_file pero no en files	El archivo nunca llega al jugador.	Añade la misma ruta a files.
Ruta o nombre de carpeta incorrectos	No se carga nada.	Las rutas son relativas a la carpeta del resource y usan barras normales.
Tipo equivocado para el archivo	El archivo va al cargador equivocado y sus datos no se aplican.	Usa el tipo de la tabla de arriba.
Metas colocados en stream/	No se cargan como archivos de datos.	Deja los metas fuera de stream y decláralos.
Falta fx_version o game	El resource no carga bien.	Empieza el manifest con fx_version 'cerulean' y game 'gta5'.

El proceso completo, desde las carpetas hasta el spawn, está en cómo añadir un vehículo add-on a FiveM.