Cómo añadir coches add-on a FiveM

El problema

Has descargado un coche personalizado (un pack con archivos .yft, .ytd y varios .meta) y quieres meterlo en tu servidor, pero no sabes cómo montar el recurso. Al arrancar, o el recurso no carga, o el vehículo no aparece al hacer /car y la consola se queja de los meta.

La causa

Un coche add-on no es solo el modelo 3D: es un recurso completo. FiveM necesita que los modelos (.yft) y texturas (.ytd) vivan dentro de una carpeta `stream/`, y que el `fxmanifest.lua` declare cada archivo .meta con su data_file correcto (vehicles.meta, handling.meta, carcols.meta, carvariations.meta). Si falta cualquiera de esos data_file, o el spawn name no coincide con el de vehicles.meta, el juego no registra el vehículo y `/car` no lo encuentra.

La solución

Crea una carpeta de recurso con los modelos dentro de stream/ y un fxmanifest.lua que cargue los cuatro .meta con su data_file correspondiente. El spawn name (el nombre que usarás con /car) se define dentro de vehicles.meta, en el campo <modelName>:

-- fxmanifest.lua de un coche add-on
-- Estructura del recurso:
--   mi_coche/
--   ├─ fxmanifest.lua
--   ├─ vehicles.meta
--   ├─ handling.meta
--   ├─ carcols.meta
--   ├─ carvariations.meta
--   └─ stream/
--      ├─ micoche.yft      (modelo)
--      ├─ micoche_hi.yft   (LOD de detalle)
--      └─ micoche.ytd      (texturas)

fx_version 'cerulean'
game 'gta5'

-- Todos los .yft y .ytd dentro de stream/ se sirven automáticamente,
-- pero los .meta hay que declararlos como files{} + data_file:
files {
    'vehicles.meta',
    'handling.meta',
    'carcols.meta',
    'carvariations.meta',
}

data_file 'VEHICLE_METADATA_FILE'  'vehicles.meta'      -- define el spawn name (<modelName>)
data_file 'HANDLING_FILE'          'handling.meta'      -- físicas/conducción
data_file 'CARCOLS_FILE'           'carcols.meta'       -- modkits, colores, extras
data_file 'VEHICLE_VARIATION_FILE' 'carvariations.meta' -- variaciones (colores por defecto, kits)

Paso a paso

1. 1.Crea una carpeta para el recurso (por ejemplo `mi_coche`) dentro de `resources` o de un sub-recurso `[cars]`. El nombre de la carpeta es el nombre del recurso, no el del coche.
2. 2.Dentro, crea una subcarpeta `stream/` y mete ahí los modelos y texturas: el `.yft` del modelo (y su `_hi.yft` si lo trae) y el `.ytd` de texturas. FiveM sirve automáticamente todo lo que haya en `stream/`.
3. 3.Coloca los cuatro .meta en la raíz del recurso (vehicles.meta, handling.meta, carcols.meta, carvariations.meta) y crea el `fxmanifest.lua` declarándolos con su `data_file` correcto, como en el ejemplo de arriba.
4. 4.Averigua el spawn name: ábrelo en `vehicles.meta` y busca el campo `<modelName>`. Ese texto (por ejemplo `micoche`) es el nombre exacto que usarás para spawnear. No tiene por qué coincidir con el nombre de la carpeta.
5. 5.Añade `ensure mi_coche` en tu server.cfg y reinicia el servidor completo (no basta con refrescar el recurso para que el streaming registre los modelos nuevos).
6. 6.Pruébalo en el juego con `/car micoche` (o el spawn name real) si tienes un menú/comando de admin que lo permita, o spawnéalo desde tu menú de vehículos. Debe aparecer con sus físicas y colores correctos.
7. 7.Si no aparece o sale como un cubo sin texturas, usa OpenIV para abrir el `.yft`/`.ytd` y verifica que el modelo no esté corrupto y que los nombres internos coincidan con lo declarado en los .meta.
8. 8.Vigila el peso y el streaming: cada coche de alta poligonización y texturas 4K consume memoria de streaming. Si metes muchos, los jugadores con pocos recursos verán modelos sin cargar o caídas de FPS; reduce texturas o limita la cantidad de add-ons activos.
9. 9.SEGURIDAD: descarga packs solo de fuentes fiables. Muchos packs de coches gratuitos de sitios dudosos incluyen un .lua o un recurso extra con un backdoor. Antes de poner cualquier pack en producción, revísalo: un coche add-on legítimo NO necesita scripts de servidor; si trae .lua sospechosos, eventos raros o código ofuscado, no lo uses y escanéalo.

Guías relacionadas