¿Un coche addon de FiveM no aparece? Errores habituales y cómo hallarlos

Añadiste un coche, reiniciaste, escribiste su nombre de spawn y no pasó nada. O aparece sin texturas, o conduce exactamente igual que otro coche. Un coche addon son unos cuantos archivos que tienen que apuntarse entre sí por nombre, y basta con un nombre mal para romperlo.

De qué está hecho un coche addon

• stream/: el modelo (<name>.yft, y <name>_hi.yft para verlo de cerca) y sus texturas (<name>.ytd).
• Los metas: vehicles.meta (el coche en sí), handling.meta, carvariations.meta (colores, kits, liveries) y a menudo carcols.meta (sirenas, luces, kits de modificación).
• El fxmanifest, que enumera los metas en files y carga cada uno con su línea 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'

Los errores habituales

• Sin fxmanifest.lua (ni un __resource.lua antiguo, o está llamado .off): FiveM no carga la carpeta en absoluto.
• Una línea data_file que apunta a un archivo que no existe, o un meta en la carpeta que ningún data_file carga.
• Sin bloque files { }: los metas tienen que estar listados ahí, o es posible que los jugadores nunca los reciban.
• modelName que no coincide con el .yft. El nombre de spawn es el nombre del modelo; un archivo con otro nombre nunca se encuentra.
• txdName que no coincide con el .ytd: el coche aparece sin textura.
• handlingId que no está en ningún handling.meta, ni el del pack ni el del juego.
• Un id de sirena o un nombre de kit de modificación en carvariations.meta que nada define: sin sirenas, o sin piezas de tuning.
• Dos archivos con el mismo nombre en la carpeta stream: solo se usa uno de ellos.

Los nombres de más de 11 caracteres son otra trampa: el juego corta ahí un gameName, y algunos scripts hacen lo mismo con el nombre del modelo.

Encuéntralo en segundos

Arrastra la carpeta de recursos del coche a Vehicle Pack Check. Funciona en tu navegador (no se sube nada) y revisa todo lo anterior contra los handlings, sirenas y kits de modificación del juego, y luego enumera lo que encontró, primero los errores: "No fxmanifest.lua", "<model>.yft is not in the folder" (<model>.yft no está en la carpeta), "Its textures, <txd>.ytd, are not in the folder" (sus texturas, <txd>.ytd, no están en la carpeta), "handlingId X is in no handling.meta here or in the game" (handlingId X no está en ningún handling.meta aquí ni en el juego)…

Los errores impiden que un coche cargue o funcione: arréglalos primero. Los avisos son cosas que funcionan pero se ven mal, como un _hi.yft que falta (el coche usa su modelo normal de cerca) o un archivo transmitido de más de 16 MB.

¿Solo tienes el .yft y el .ytd?

Si el coche llegó como un .yft y un .ytd sueltos, sin metas, Vehicle Addon Builder los escribe. Arrastra el modelo, elige el coche del juego más parecido como plantilla (sugerido por tamaño, ruedas y tipo), define su nombre de spawn (hasta 11 caracteres) y el nombre que se muestra en el juego, ajusta la masa, la velocidad, el frenado y el agarre si quieres, y descarga un recurso listo con los metas, las líneas data_file y un README. También revisa el modelo: sin asiento para el conductor, sin colisión, ruedas invisibles.

Después, haz ensure, reinicia y spawnéalo por su nombre de spawn (con el comando de tu framework, como /car <name> en ESX, o desde txAdmin).

Preguntas

Aparece pero sin texturas. ¿Por qué?

Su txdName en vehicles.meta no coincide con ningún .ytd de la carpeta stream. Para las partes que siguen en blanco, mira por qué las texturas de FiveM salen blancas o moradas.

¿Necesito carcols.meta?

Solo para las sirenas, luces o kits de modificación propios del coche. Sin él, el coche usa lo que señala su carvariations.meta.

La herramienta para esto

Vehicle Pack Check

Arrastra la carpeta de recursos de tu vehículo: metas que faltan, nombres incorrectos y errores de stream, primero los errores, con lo que hay que arreglar.

Abrir Vehicle Pack Check

También útil aquí: Vehicle Addon Builder