¿Cómo añadir coches addon a tu servidor FiveM?

GTA V incluye de serie cientos de vehículos, pero un servidor de roleplay o de carreras solo destaca de verdad con coches custom. En esta guía instalarás un vehículo addon en tu servidor FiveM: subirás el recurso por SFTP, lo activarás en server.cfg, lo probarás dentro del juego y después pondrás el coche a la venta en la tienda de vehículos de ESX o QBCore.

Addon o replace: ¿cuál es la diferencia?

Los vehículos custom se distribuyen de dos maneras. Un vehículo replace sobrescribe un modelo existente de GTA: sus archivos llevan el nombre de un coche original (por ejemplo adder.yft) y todo el que spawnee ese modelo verá a partir de entonces el coche nuevo. Un vehículo addon se añade al juego como un modelo completamente nuevo con su propio spawn name, sin sobrescribir nada. Addon es casi siempre la mejor opción: conservas todos los coches originales, evitas conflictos entre recursos y puedes darle al vehículo su propio precio y categoría en la tienda. Por eso esta guía se centra en coches addon.

La estructura de carpetas de un recurso de vehículo

Un coche addon es un recurso normal de FiveM. Dentro de la carpeta encontrarás normalmente esto:

• fxmanifest.lua — describe el recurso y apunta a los archivos meta.
• stream/ — los archivos del modelo: .yft (el modelo 3D, a menudo con una variante _hi.yft) y .ytd (las texturas).
• data/ — los archivos meta: vehicles.meta (nombre del modelo y datos de spawn), carvariations.meta (colores y variantes), carcols.meta (opciones de tuning y luces) y handling.meta (comportamiento de conducción). Algunos coches traen archivos extra como vehiclelayouts.meta.

El spawn name lo encontrarás en vehicles.meta, dentro de la etiqueta <modelName> — en esta guía usamos sultan3 como ejemplo. Necesitarás ese nombre más adelante para spawnearlo y para la tienda.

Paso 1: sube el recurso por SFTP

1. Conéctate a tu servidor por SFTP, por ejemplo con FileZilla o WinSCP. En nuestro artículo sobre SFTP te explicamos cómo.
2. Abre la carpeta resources de tu servidor FiveM. Resulta práctico usar una subcarpeta entre corchetes, como resources/[cars] — FiveM escanea automáticamente las carpetas entre corchetes.
3. Sube la carpeta completa del vehículo (por ejemplo sultanclassic) a esa subcarpeta.
4. Comprueba que fxmanifest.lua está directamente dentro de la carpeta del vehículo y no en una carpeta anidada de más — el error más habitual con descargas descomprimidas.

Paso 2: activa el recurso en server.cfg

1. En el panel de MC-Node, abre la pestaña Files y abre el archivo server.cfg.
2. Añade una línea al final: ensure sultanclassic. Usa aquí el nombre de la carpeta del recurso, no el spawn name.
3. Guarda el archivo y reinicia tu servidor desde la pestaña Console.

Paso 3: prueba el coche dentro del juego

1. Entra en tu servidor, abre tu menú de administración — vMenu o el menú de txAdmin, por ejemplo — y elige la opción de spawnear un vehículo.
2. Introduce el spawn name (sultan3). En un servidor ESX con los comandos por defecto también funciona /car sultan3.
3. Si el coche aparece, el recurso está funcionando. Aprovecha para comprobar la conducción y que todas las texturas cargan.

Poner el coche a la venta en ESX

El esx_vehicleshop por defecto lee su catálogo de la tabla vehicles de la base de datos.

1. En el panel, abre la pestaña Databases e inicia sesión en el panel de base de datos (phpMyAdmin) con las credenciales que se muestran allí.
2. Selecciona la base de datos de tu servidor y abre la ventana SQL.
3. Ejecuta esta consulta: INSERT INTO vehicles (name, model, price, category) VALUES ('Sultan RS Classic', 'sultan3', 125000, 'sports');
4. Ojo: model debe coincidir exactamente con el spawn name y la category debe existir en la tabla vehicle_categories.
5. Reinicia el recurso de la tienda de vehículos o el servidor entero; el coche ya aparece en el concesionario.

Poner el coche a la venta en QBCore

QBCore no usa una tabla de base de datos, sino un archivo de configuración compartido.

1. Desde la pestaña Files, abre el archivo resources/[qb]/qb-core/shared/vehicles.lua.
2. Añade una nueva entrada, por ejemplo: { model = 'sultan3', name = 'Sultan RS Classic', brand = 'Karin', price = 125000, category = 'sports', type = 'automobile', shop = 'pdm' },
3. El valor shop = 'pdm' coloca el coche en la tienda de vehículos por defecto; category determina en qué pestaña aparece dentro del menú de la tienda.
4. Reinicia el servidor por completo desde la pestaña Console — los archivos compartidos solo se cargan al arrancar.

Problemas frecuentes

• Lag de streaming o coches invisibles — Los archivos .ytd demasiado grandes (texturas 4K de decenas de megabytes) llenan la memoria de texturas de los jugadores, con lag, pop-in o vehículos invisibles como resultado. Reduce las texturas a 2K o usa una versión optimizada del coche.
• Spawn names duplicados — Dos recursos con el mismo modelName entran en conflicto: el coche no spawnea o aparece el modelo equivocado. Elimina uno de los dos recursos o renombra el modelo, los nombres de archivo y todas las referencias meta de forma coherente.
• El coche no aparece en la tienda — Normalmente se ha olvidado la categoría de la tienda o es incorrecta. En ESX la categoría debe existir en vehicle_categories; en QBCore debe coincidir con las categorías de la config de la tienda. Comprueba también que el spawn name en la tienda es exacto.
• El recurso no arranca — Mira el mensaje de error en la pestaña Console. ¿Coincide el nombre de la carpeta en la línea ensure y está fxmanifest.lua directamente en la carpeta del vehículo?
• Model not found al spawnear — El recurso no está en marcha o estás escribiendo mal el spawn name. Verifica el nombre en vehicles.meta y reinicia el servidor después de los cambios.

Para seguir leyendo

¿Es tu primera vez con bases de datos? Lee cómo crear una base de datos y cómo conectarte a tu base de datos. Si tu servidor sigue yendo lento después de añadir coches, echa también un vistazo a nuestra guía sobre el lag del servidor. ¿Sigues atascado? Abre un ticket en nuestra página de soporte e indica el nombre del recurso y el mensaje de error de la consola.