$ USD
  • $ USD
  • € EUR
  • £ GBP
Configuración de fxmanifest.lua (FiveM)

Configuración de fxmanifest.lua para FiveM (Ejemplos de copia y pegado)

Respuesta rápida: cada recurso FiveM necesita un fxmanifest.lua archivo en la carpeta de recursos. Le indica a FXServer a qué juego apoya el recurso, qué scripts cargar y qué archivos van a los clientes. A continuación se presentan ejemplos para copiar y pegar para un recurso de script estándar, scripts compartidos/cliente/servidor, recursos NUI (ui_page + files), y mapas (this_is_a_map 'yes' con flujos de ymap), además de correcciones para errores comunes del manifiesto.

Ú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 'cerulean' para recursos modernos de FiveM a menos que el autor del recurso documente un requisito diferente.

Ejemplo completo con metadatos

fx_version 'cerulean'
game 'gta5'

author 'Your Name'
description 'Example FiveM resource'
version '1.0.0'

lua54 'yes'

shared_script 'config.lua'
client_script 'client.lua'
server_script 'server.lua'

El author, description, y version los campos son metadatos: no cambian cómo se ejecutan los scripts, pero FXServer imprime una advertencia en la consola como “version es requerido. por favor especifica una versión en tu fxmanifest.lua.” cuando version falta. Agrega una version '1.0.0' línea para eliminarlo. La línea opcional lua54 'yes' habilita Lua 5.4 para el recurso y es requerida por muchos frameworks y bibliotecas actuales.

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 files. 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 stream 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 server.lua bajo client_scripts.
  • Olvidar archivos NUI bajo files.
  • Poner secretos dentro shared_scripts.
  • Escribir mal nombres de carpetas, especialmente client, server, y stream.

Lista de verificación

  1. La carpeta del recurso tiene fxmanifest.lua en el nivel superior.
  2. game 'gta5' 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 files.
  5. server.cfg incluye ensure resource-name.

Guías relacionadas

Orden de dependencias en server.cfg

El manifiesto le indica a FiveM qué archivos pertenecen a un recurso, pero server.cfg aún controla el orden de inicio. Inicie las bibliotecas compartidas y las dependencias del framework antes que los recursos que las usan.

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

Si un recurso muestra errores de exportación al inicio, verifique si la dependencia está instalada, nombrada correctamente y asegurada antes del script que la llama.

Notas específicas del framework

Los recursos de ESX, QBCore y Qbox a menudo necesitan importaciones del framework, bibliotecas de base de datos y archivos de configuración. Mantenga la configuración del framework en archivos documentados. No oculte configuraciones importantes en archivos de cliente aleatorios. Un manifiesto limpio facilita el soporte porque el personal puede ver cada archivo que se carga.

Lista de verificación antes de publicar un script

  • Sin secretos en archivos compartidos o de cliente.
  • No hay archivos de prueba no utilizados listados en el manifiesto.
  • Todos los activos NUI listados bajo files.
  • Dependencias documentadas en el README o la descripción del producto.
  • El recurso se inicia correctamente después de un reinicio completo del servidor.

El orden de las dependencias aún importa

El manifiesto le dice a FXServer qué archivos pertenecen a un recurso, pero server.cfg aún controla el orden de inicio. Inicie las bibliotecas compartidas, frameworks y dependencias de base de datos antes que los scripts que los llaman. Si un recurso arroja errores de exportación al iniciar, verifique el nombre y orden de la dependencia antes de editar el script en sí.

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

Revise antes de enviar un recurso

Verifique que los archivos del cliente no contengan secretos, que los archivos del servidor no se envíen al cliente, que los activos NUI estén listados bajo files, y las dependencias se nombren exactamente como están instaladas. Un manifiesto funcional debería hacer que el recurso sea comprensible para otro desarrollador sin abrir cada archivo Lua.

Si un script utiliza exportaciones de framework, bibliotecas de base de datos o configuración compartida, documente eso en el README o en las notas del producto. La mayoría de los problemas de instalación provienen de dependencias faltantes o un orden de inicio incorrecto, no de la sintaxis del manifiesto en sí.

Después de editar el manifiesto, reinicie el servidor completo una vez. Las recargas en caliente pueden ocultar archivos faltantes o problemas de orden que solo aparecen en un inicio limpio.

Si el inicio limpio falla, lea el primer error, no la última cascada de errores después de que las dependencias ya estén rotas.

capas de fxmanifest.lua para metadatos, scripts, dependencias y archivos
Un manifiesto de recurso declara metadatos, scripts ejecutables, dependencias y archivos empaquetados.

Lee un fxmanifest en cuatro capas

  • Metadatos: declara la versión de FX, el juego soportado y detalles útiles del autor, descripción y versión.
  • Guiones: separar la ejecución del cliente, servidor y compartida deliberadamente; no expongas la lógica solo del servidor a los clientes.
  • Dependencias: estado de los recursos o restricciones de tiempo de ejecución que deben existir antes de que este recurso pueda ejecutarse.
  • Archivos: incluir NUI y activos de datos que los clientes necesitan. Cfx.re notas que un local ui_page y sus dependencias deben ser referenciadas en files.

El manifiesto es Lua semi-declarativo ejecutado por separado de los scripts del recurso. Manténlo explícito, elimina las entradas obsoletas y verifica cada ruta referenciada en un sistema de archivos de producción sensible a mayúsculas y minúsculas.

Referencia de manifiesto de recurso Cfx.re

Revisión editorial y política de fuentes

Los ejemplos de manifiesto se mantuvieron porque coinciden con el modelo actual de manifiesto de recursos Cfx.re. La referencia oficial del manifiesto es la autoridad para las directivas, y los ejemplos obsoletos __resource.lua no deben introducirse.

Esta página fue revisada técnicamente el 9 de agosto de 2026. Los comandos y la configuración deben verificarse con la documentación principal vinculada y la versión exacta del recurso instalada en el servidor. Pruebe los cambios en el entorno de prueba, registre la línea de base y conserve una copia de reversión antes de cambiar la producción.

Deja una respuesta