Cómo añadir coches mods en FiveM GTA RP: guía paso a paso

Añadir coches personalizados en un servidor FiveM RP es una de las demandas más comunes de los owners — y también una de las que más quebraderos de cabeza provoca por mala organización. El problema rara vez está en el archivo del coche en sí: está en la estructura del resource, en los metadatos obligatorios y en el orden de streaming.

Este tutorial es para owners y desarrolladores de servidores FiveM GTA RP que quieren añadir vehículos addon (que no sustituyen coches vanilla) de forma organizada, sin romper los concesionarios del framework y sin convertir la carpeta [cars] en algo ingobernable con 400 resources sueltos.

Tiempo estimado de ejecución: 20 a 30 minutos por coche, o 1 hora para montar un pack organizado con 10 a 20 vehículos. Voy a cubrir desde la estructura de carpetas hasta el registro en la base de datos para que el coche aparezca en el concesionario de tu framework.

Requisitos previos

Asegúrate de que no estás corriendo en modo OneSync legacy en un servidor moderno — los addons de coche funcionan mejor en OneSync infinity, que es el estándar actual de FiveM.

Estructura de carpetas del resource

La primera regla: un resource por coche o un resource por pack temático (coches policiales, supercoches, sedanes). No mezcles coches aleatorios en un único resource gigante — depurar se vuelve imposible cuando uno de ellos se rompe.

La estructura estándar de un coche addon es:

resources/[cars]/lambo2024/
├── fxmanifest.lua
├── stream/
│   ├── lambo2024.yft
│   ├── lambo2024_hi.yft
│   └── lambo2024.ytd
└── data/
    ├── vehicles.meta
    ├── carvariations.meta
    ├── carcols.meta
    └── handling.meta

La carpeta [cars] con corchetes es una categoría — FiveM la reconoce automáticamente y organiza todos los resources de coches dentro de ella. No es obligatoria, pero mantiene el resources/ limpio cuando tienes 200 coches.

Creando el resource paso a paso

Voy a usar como ejemplo un coche ficticio llamado lambo2024. Sustituye por el nombre de tu modelo en todos los comandos.

cd /ruta/del/servidor/resources
mkdir -p [cars]/lambo2024/stream
mkdir -p [cars]/lambo2024/data

# vía SFTP o cp local
cp lambo2024.yft     [cars]/lambo2024/stream/
cp lambo2024_hi.yft  [cars]/lambo2024/stream/
cp lambo2024.ytd     [cars]/lambo2024/stream/

fx_version 'cerulean'
game 'gta5'

author 'NombreDelCreador'
description 'Lamborghini 2024 Addon'
version '1.0.0'

files {
    'data/vehicles.meta',
    'data/carvariations.meta',
    'data/carcols.meta',
    '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'
data_file 'HANDLING_FILE'            'data/handling.meta'

# server.cfg
ensure [cars]
# o para resources individuales:
ensure lambo2024

refresh
ensure lambo2024

Validando los metadatos

La mayoría de los bloqueos vienen de vehicles.meta o handling.meta mal formados. Vale la pena revisarlos manualmente antes del primer arranque.

<Item>
    <modelName>lambo2024</modelName>
    <txdName>lambo2024</txdName>
    <handlingId>lambo2024</handlingId>
    <gameName>lambo2024</gameName>
    <vehicleMakeName>LAMBORGHINI</vehicleMakeName>
    <!-- resto de la config -->
</Item>

<Item type="CHandlingData">
    <handlingName>lambo2024</handlingName>
    <fMass value="1700.00" />
    <fInitialDragCoeff value="9.85" />
    <!-- ... -->
</Item>

Registrando el coche en el framework RP

Añadir el resource no es suficiente — el coche tiene que estar en la tabla vehicles de la base de datos para aparecer en el concesionario y poder ser comprado por los jugadores.

ESX Framework

En ESX legacy, conecta al MySQL y ejecuta:

INSERT INTO vehicles (name, model, price, category)
VALUES ('Lamborghini 2024', 'lambo2024', 850000, 'super');

El campo model debe ser EXACTAMENTE el spawn name del coche (mismo valor que el <modelName> del vehicles.meta).

QBCore Framework

En QBCore, edita qb-core/shared/vehicles.lua:

['lambo2024'] = {
    ['name'] = 'Lamborghini 2024',
    ['brand'] = 'Lamborghini',
    ['model'] = 'lambo2024',
    ['price'] = 850000,
    ['category'] = 'super',
    ['hash'] = `lambo2024`,
    ['shop'] = 'pdm',
},

Reinicia qb-core después (restart qb-core en la consola).

Verificación

Para confirmar que todo funcionó, entra en el servidor como admin y usa:

/car lambo2024

O en frameworks con un comando propio de spawn (/spawncar en ESX, /admincar en algunos scripts QB). El coche debe aparecer con la textura completa, sonido de motor y física consistente.

Comprueba también la consola del servidor durante el arranque. Salida esperada:

Started resource lambo2024
Loading vehicle metadata: data/vehicles.meta
Loading handling: data/handling.meta

Si aparece Failed to load, Unable to parse XML o Duplicate handling ID, el error está en uno de los .meta. Mira la sección de resolución de problemas más abajo.

Resolución de problemas

El coche aparece sin textura (chequered)

Causa: divergencia entre modelName en el vehicles.meta y el nombre del .yft, o falta el .ytd en el stream. Solución: confirma que los 3 nombres coincidan (archivo, modelName, txdName) y que el .ytd esté en stream/.

Error “Vehicle not found” al usar /car

Causa: el resource no se ha cargado o ensure no está en el server.cfg. Solución: ejecuta refresh seguido de ensure lambo2024 en la consola. Si persiste, revisa que el fxmanifest.lua declare los 4 data_file correctamente.

El servidor se bloquea durante la carga

Causa: handling.meta con un valor inválido (texto donde espera número) o XML mal formado. Solución: ejecuta developer 1 en la consola del servidor antes del arranque para ver mensajes detallados. Generalmente el error apunta a la línea exacta.

El coche aparece en el concesionario pero no se puede comprar

Causa: el registro en la base de datos tiene un model incorrecto. Solución: confirma que el valor del campo model en la tabla vehicles sea idéntico al spawn name (case-sensitive).

Próximos pasos

Después de tener el primer coche funcionando, vale la pena automatizar el resto del flujo:

• Crear un pack único con 10 a 30 coches agrupados por categoría (super, sport, sedan) en vez de 30 resources separados.
• Añadir carcols.meta personalizado para liberar tuning visual en tus coches (llantas, capós, escapes).
• Implementar lazy load con set sv_streamerMode 1 en servidores con 400+ vehículos para reducir el tiempo de descarga inicial.
• Configurar un handling realista usando herramientas como el Handling Editor in-game antes de exportar al .meta final.
• Versionar el [cars]/ en un git aparte para rastrear cambios y hacer rollback fácil.

Si estás corriendo un servidor FiveM RP en producción con un pack pesado de coches, una VPS dedicada para game servers de Hostini entrega CPU single-thread alto y SSD NVMe — lo que marca una diferencia real en el tiempo de stream de assets cuando 64 jugadores se conectan al mismo tiempo.