Configurando fxmanifest.lua para FiveM

Respuesta rápida: todo recurso moderno de FiveM debe incluir un fxmanifest.lua archivo en la carpeta del recurso. Le indica a FXServer qué juego soporta el recurso, qué scripts cargar y qué archivos deben enviarse a los clientes.

Última actualización: 25 de junio de 2026

fxmanifest.lua mínimo

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

La documentación oficial de manifiesto de recursos de Cfx.re identifica fxmanifest.lua como el archivo de manifiesto actual y señala que los __resource.lua manifiestos antiguos están obsoletos. Usa fx_version 'cerúleo' para recursos modernos de FiveM a menos que el autor del recurso documente un requisito diferente.

Scripts de cliente, servidor y compartidos

fx_version 'cerulean'
game 'gta5'

shared_scripts {
    'config.lua',
    '@ox_lib/init.lua'
}

client_scripts {
    'client/*.lua'
}

server_scripts {
    '@oxmysql/lib/MySQL.lua',
    'server/*.lua'
}

Usar shared_scripts solo para archivos que sean seguros en ambos lados. No pongas secretos del servidor, claves de licencia, contraseñas de bases de datos ni URLs de webhook en archivos compartidos.

Ejemplo de recurso NUI

fx_version 'cerulean'
game 'gta5'

ui_page 'web/index.html'

files {
    'web/index.html',
    'web/style.css',
    'web/app.js'
}

client_script 'client.lua'

Si un UI aparece en blanco en el juego, verifica que cada archivo HTML, CSS, JavaScript, fuente e imagen esté listado bajo archivos. Los archivos faltantes son una causa común de pantallas NUI rotas.

Ejemplo de recurso de mapa o MLO

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ymap',
    'stream/*.ytyp'
}

Para mapas e interiores, mantén los archivos de stream en una arroyo carpeta y verifica que el recurso se inicie sin advertencias en la consola. Si un mapa no carga, usa la consola FiveM y los logs de txAdmin antes de editar recursos no relacionados.

Errores comunes

• Usando __resource.lua en un nuevo recurso.
• Poner servidor.lua bajo scripts de cliente.
• Olvidar archivos NUI bajo archivos.
• Poner secretos dentro shared_scripts.
• Escribir mal nombres de carpetas, especialmente cliente, servidor, y arroyo.

Lista de verificación

1. La carpeta del recurso tiene fxmanifest.lua en el nivel superior.
2. juego 'gta 5' está presente para FiveM.
3. Los archivos de cliente se cargan en el cliente, los archivos de servidor se cargan en el servidor.
4. Cada archivo NUI/estático está listado bajo archivos.
5. servidor.cfg incluye asegurar nombre-del-recurso.

Guías relacionadas

• Introducción a la programación en Lua para FiveM
• Cómo escribir scripts de FiveM usando IA
• Cómo revisar los registros de txAdmin

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure my-script