Instalar y probar coches personalizados en un servidor FiveM

Para instalar un vehículo adicional, coloca su recurso completo de FiveM en la carpeta resources de tu servidor, inicia ese recurso y genera el modelo nombrado en vehicles.meta. Prueba el vehículo antes de añadirlo a un concesionario o fusionarlo con otros paquetes.

Confirma la edición de GTA de destino antes de instalar o exportar assets. Los paquetes de Legacy no son automáticamente compatibles con Enhanced; sigue la guía oficial de conversión de activos de Enhanced cuando ese sea tu objetivo.

Comprueba primero el paquete

Utiliza un paquete que tengas permiso para ejecutar y distribuir a los jugadores que se conectan. Conserva su archivo comprimido original y su README. Un recurso preparado para FiveM normalmente incluye un manifiesto y archivos de modelos, texturas y metadatos. Un instalador .oiv para un jugador o un plugin .asi no es un recurso de servidor.

Un complemento introduce un modelo separado. Un reemplazo sobrescribe intencionalmente un nombre de modelo existente. Comprueba qué tipo tienes para no reemplazar accidentalmente la flota predeterminada.

1. Instala un recurso

Para un recurso llamado my_vehicle, el manifiesto debería estar en resources/[cars]/my_vehicle/fxmanifest.lua, no dentro de una carpeta de extracción anidada adicional. Conserva las rutas y el caso de los nombres de archivo suministrados. Los hosts Linux distinguen entre mayúsculas y minúsculas.

Mantén un manifiesto funcional proporcionado por el autor. El ejemplo siguiente solo cubre un paquete cuyos cuatro archivos de metadatos nombrados existen realmente en data/; otros paquetes pueden necesitar registros adicionales.

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'

Mantén los modelos .yft y las texturas .ytd suministrados en sus rutas de streaming. Si el autor proporciona archivos de layouts, audio u otros datos, conserva las entradas correspondientes del manifiesto; no las descartes para reproducir este ejemplo.

2. Inicia el recurso

Añade ensure my_vehicle al server.cfg activo. En un servidor de desarrollo en ejecución, ejecuta estos dos comandos por separado en la consola de FXServer:

refresh
ensure my_vehicle

Lee la salida de inicio. Resuelve los archivos faltantes, el XML mal formado o los errores de dependencia antes de generar el coche. Inicia un nuevo recurso a la vez para que un fallo tenga un propietario claro.

3. Usa el nombre del modelo

Abre vehicles.meta y busca el modelName del vehículo. Ese es el nombre del modelo utilizado para generarlo. gameName es una etiqueta de texto visible y puede ser diferente. Introduce el nombre del modelo en la herramienta administrativa de generación de vehículos que tengas instalada y estés autorizado a utilizar.

Inspecciona las ruedas, luces, puertas, asientos, libreas, tuning, colisión y manejo. Prueba con otro jugador conectado y después de una reconexión. Que un modelo aparezca una vez no prueba que todos sus metadatos funcionen.

4. Añade propiedad e integración con la tienda

Una vez que la generación funcione, sigue la configuración real o el esquema de la base de datos del recurso de la tienda de vehículos. El nombre del framework por sí solo no identifica ese esquema. Usa el mismo nombre de modelo, la categoría deseada y un precio deliberado.

Prueba la compra, la asignación de llaves, el almacenamiento en el garaje, la recuperación y la persistencia después de reiniciar. Elimina los vehículos de prueba y las compras de prueba a través de las herramientas administrativas adecuadas. Haz una copia de seguridad de cualquier dato modificado durante la integración.

Si tienes un DLC de un solo jugador

Inspecciona el archivo con la herramienta de autoría adecuada e identifica sus modelos, texturas y todas las dependencias de metadatos. La conversión puede implicar audio personalizado, diseños y piezas de tuning más allá del ejemplo de cuatro archivos. Prefiere las instrucciones de FiveM del autor cuando estén disponibles; extraer dos archivos de modelo no es una conversión completa.

Solución de problemas por síntoma

Si no aparece nada, verifica el inicio y el modelName. Si aparece el coche equivocado, busca colisiones de nombres de modelo entre recursos. Para texturas o tuning faltantes, compara los metadatos y las dependencias transmitidas con el paquete original. Para fallos, registra el fallo exacto y prueba el vehículo solo en una compilación de juego compatible.

Mide el comportamiento gráfico/de streaming en una escena repetible con el número esperado de vehículos. El tiempo de script del cliente en Resmon no mide la geometría del modelo ni el coste de la textura de la GPU. Mantén una fácil reversión conservando cada paquete probado por separado.

Documentación de referencia

Cfx.re — manifiesto de recursos · Cfx.re — archivos de datos · Fuente: dexyfex/CodeWalker