El resource de FiveM no arranca: soluciona el error según el mensaje de la consola

Un resource de FiveM no arranca cuando el servidor no lo encuentra, no puede leer su manifiesto, lo inicia antes que una dependencia, aparece un error de Lua o se deniega el derecho de uso (entitlement). Busca el primer error que nombre el resource y usa después la sección correspondiente de abajo.

Los mensajes solo se citan cuando una página de Cfx.re, la documentación de un framework o de una librería, la documentación de un vendedor o una publicación del foro de Cfx.re los muestra; la fuente aparece junto a cada uno. Donde no se pudo verificar un mensaje exacto, la sección lo indica. Esto es una revisión de documentación fechada el 2026-10-13, no una prueba práctica: nada de esto se reprodujo en un servidor.

Lee primero la consola

1. Reinicia el servidor y busca el nombre del resource en la consola del servidor (o en la Live Console de txAdmin, mira Cómo encontrar y leer los logs de txAdmin).
2. Toma el primer error que lo mencione. Las líneas posteriores suelen ser consecuencias: una dependencia que falla hace fallar a todos los resources que la necesitan.
3. Copia esa línea con la ruta del archivo y el número de línea, y anota la versión del resource, el framework, el número de artifact de FXServer y la edición de GTA V.

El probador de scripts de FiveM incluye un explicador de errores que se ejecuta en tu navegador; oculta las claves de licencia y las IP antes de compartir cualquier log.

¿Qué mensaje ves?

Ves	Apunta a	Fuente
Couldn't find resource	La carpeta o el manifiesto no está donde lo busca el servidor	Hilo del foro de Cfx.re
does not specify an `fx_version` in fxmanifest.lua y luego Couldn't start resource ...	Falta la versión del manifiesto o no es compatible	Hilo del foro de Cfx.re
Could not start dependency X for resource Y.	El resource X falló primero	El mismo hilo
No such export ... in resource ...	El proveedor no está en marcha, arranca más tarde o el nombre del export es incorrecto	Documentación de ox_inventory
Error parsing script / Error loading script / Failed to load script	Error de sintaxis de Lua o error al cargar	Foro, foro
You lack the required entitlement	La clave del servidor y el propietario del resource no coinciden	Documentación de Asset Escrow
Native XXXXXXXX is not supported	Artifact del servidor desactualizado	Documentación de ESX

1. El servidor no encuentra el resource

Significado: la introducción al scripting de Cfx.re dice que un resource necesita un manifiesto para ser detectado. Si no hay una carpeta con ese nombre que contenga un fxmanifest.lua legible, no hay nada que iniciar.

Comprobar: lista la ruta. Lo que buscas es resources/[optional_group]/resource_name/fxmanifest.lua. Los zip pueden descomprimirse como resource_name/resource_name/fxmanifest.lua. Compara el nombre que va después de ensure con el nombre de la carpeta, incluidos -, _ y, en Linux, las mayúsculas y minúsculas. Para una carpeta añadida mientras el servidor está en marcha, refresh vuelve a escanear resources y carga los manifiestos (comandos del servidor).

Solución: sube la carpeta interior un nivel, corrige el nombre, ejecuta refresh y luego ensure resource_name. Si faltan todos los resources personalizados mientras los predeterminados funcionan, revisa también la subida: en el hilo del foro enlazado arriba, quien lo publicó contó que cambiar de cliente FTP (de WinSCP a FileZilla) lo arregló, sin saber por qué. Es una anécdota aislada, y la documentación de vendedores citada en la sección 5 cuenta lo contrario para los archivos protegidos (FileZilla los corrompe). Volver a subir el archivo comprimido y extraerlo en el servidor es la prueba más segura.

2. El manifiesto falta, es incorrecto o es demasiado nuevo

Significado: la referencia del manifiesto dice que un resource debe especificar una versión de manifiesto, y que los resources sin ella reciben actualmente un valor por defecto que se planea eliminar. Enumera cerulean, bodacious y adamant como valores de fx_version, y gta5 y rdr3 entre los valores de game.

Comprobar: abre fxmanifest.lua y comprueba que tenga fx_version y game. En el hilo del foro, las respuestas no coinciden: una dice que el valor bodacious requiere una build de servidor más reciente (se añadió en la 2207), otra dice que descargues el último artifact y una tercera obtuvo el mismo error en todas las builds. Trata un artifact desactualizado como una causa posible. Comprueba también que exista cada archivo listado en client_script, server_script, shared_script y files. No encontré una fuente de Cfx.re para el mensaje exacto que produce un archivo listado que falta, así que confírmalo comparando el manifiesto con el contenido de la carpeta.

Solución: restaura el manifiesto original de la descarga o actualiza el artifact. Para escribir uno: Cómo escribir y revisar un fxmanifest.lua de FiveM.

3. Una dependencia no arrancó

Significado: la directiva dependency del manifiesto exige que el resource indicado se cargue antes que el actual. En el hilo del foro, el log muestra la dependencia fallando con su propio aviso, seguido de Could not start dependency essentialmode for resource esplugin_mysql. El resource dependiente es solo el síntoma.

Comprobar: sube hasta el primer error sobre la dependencia y léelo. Después comprueba que la dependencia tenga su ensure en server.cfg (por convención, por encima de tu resource) y que el nombre del manifiesto coincida con el nombre de la carpeta de la dependencia.

Solución: repara la dependencia; mira las otras secciones para su mensaje. Referencias sobre el orden de arranque: QBCore, ESX, Qbox y Configurar el server.cfg de FiveM y verificar tus cambios.

4. No such export

Significado: la documentación de ox_inventory enumera tres causas probables de No such export * in resource ox_inventory: se produjo un error al iniciar ox_inventory o una dependencia como ox_lib; el resource que hace la llamada arranca antes que ox_inventory; o el export al que se llama no existe. El mismo patrón, no such export getPlayerData in resource mumble-voip, aparece en un hilo del foro de Cfx.re que no tiene respuesta.

Comprobar: (1) el resource indicado arrancó sin errores, (2) su línea ensure está por encima de la de quien llama, (3) el nombre del export en quien llama coincide con el código y el manifiesto del proveedor. La página del runtime de Lua añade que los exports del manifiesto solo están disponibles después del primer tick del scheduler, así que considera sospechoso el código que llama a uno muy pronto.

Solución: arregla primero el error del propio proveedor, luego el orden y por último el nombre. Nunca crees un export vacío para silenciar la línea.

5. Errores de Lua al cargar un script

En los hilos del foro aparecen dos formas: Error parsing script ... in resource ...: ... unexpected symbol (el archivo no se puede interpretar) y Error loading script ... in resource ...: ... attempt to index a nil value (global 'ESX') (el archivo se interpretó, pero falló al ejecutarse), cada una normalmente seguida de Failed to load script ....

• Objeto del framework nil. En el hilo de es_extended, Failed to load script @es_extended/imports.lua apareció junto con global 'ESX' siendo nil. Las respuestas sugerían revisar cómo incluye el manifiesto imports.lua y usar un ESX más reciente; el hilo no registra ninguna solución confirmada. Comprueba que el framework arranque primero y que el script esté pensado para la versión del framework que usas.
• Error de análisis cerca de un byte extraño. El hilo de Config muestra unexpected symbol near '<\239>' en config.lua, y después global 'Config' siendo nil en server/main.lua. El hilo no da ninguna explicación. Mi interpretación, no una causa documentada: \239 es el decimal de 0xEF, el primer byte de una marca de orden de bytes (BOM) de UTF-8, y el segundo error parece una consecuencia del primero. Vuelve a guardar el archivo como UTF-8 sin BOM y prueba de nuevo.
• Un error de sintaxis en un archivo que nunca editaste. La documentación de vendedores (Lation, JG Scripts) lista syntax error near <\1> para archivos protegidos y lo vincula con soluciones sobre transferencias corruptas o incompletas y servidores desactualizados. Vuelve a subir el archivo original, extráelo en el servidor y actualiza el artifact.

Solución: ve al archivo y la línea del primer mensaje, compáralo con tu copia de seguridad y deshaz tu última edición en los archivos de config o de ítems. No edites archivos protegidos.

6. La base de datos no está conectada

No pude verificar un mensaje de fallo universal de oxmysql, así que busca el primer error de base de datos que imprima oxmysql o el script. La documentación de oxmysql dice que definas mysql_connection_string con set (“only ever use set”) antes de iniciar los resources, que inicies oxmysql cerca del principio y que evites ; , / ? : @ & = + $ # en los valores de conexión, porque puede que no sean compatibles. La página de solución de problemas de ESX menciona “ESX Multicharacter couldn't connect to the database” y lo atribuye a una cadena de conexión incorrecta en server.cfg o a una conexión a la base de datos que no funciona.

Comprobar: el servidor de base de datos está en marcha, las credenciales funcionan en una herramienta de base de datos y existen las tablas que necesita el script. Detalles: archivos SQL y errores de base de datos y Migrar resources de mysql-async a oxmysql de forma segura.

7. Asset Escrow y la clave del servidor

Según la documentación de Asset Escrow, un resource sin entitlement no arranca y la consola muestra You lack the required entitlement. La documentación de vendedores añade que el resource está vinculado a la cuenta de Cfx.re que lo posee, por lo que la clave de registro del servidor debe proceder de esa cuenta, y que puede hacer falta un reinicio completo tras la primera instalación. Otro mensaje documentado por vendedores es [svadhesive] Failed to verify protected resource ..., que los vendedores relacionan con reinicios incompletos, subidas corruptas o la falta de un archivo .fxap. Pasos: Cómo arreglar el error Required Entitlement de FiveM y ¿Qué es un archivo .fxap en un resource de FiveM?

8. Incompatibilidad entre Legacy y Enhanced

No encontré ningún mensaje de error documentado específico de una incompatibilidad de edición. La comparativa de Cfx.re documenta diferencias que pueden impedir que un resource funcione: algunos archivos de servidor de Enhanced se llaman de otra forma (por ejemplo, cfx-server.exe en lugar de FXServer.exe), los resources pueden incluir stream_enhanced junto a stream, y Asset Escrow figura como aún no implementado para Enhanced. Si usas Enhanced, confirma que el creador da soporte a esa versión exacta; mira FiveM Standard vs Enhanced: ¿qué versión deberías usar?

Qué enviar al soporte

La primera línea de error, el nombre y la versión del resource, el framework y su versión, el número de artifact, la edición y las líneas relevantes de server.cfg sin claves ni contraseñas. Mira errores de arranque y qué necesita el soporte.

FAQ

¿Qué significa “Couldn't start resource” en FiveM?

Es el servidor diciendo que el resource no arrancó. El motivo está en las líneas anteriores, por ejemplo un aviso del manifiesto. Lee el primer error que nombre el resource.

¿Qué causa “No such export”?

El resource que proporciona el export no arrancó, arrancó después de quien llama o no tiene ese export. La documentación de ox_inventory enumera estas tres causas.

¿Qué significa “Failed to load script”?

No se pudo cargar un archivo. Las líneas de error que la rodean indican el problema real, como un error de sintaxis o un objeto del framework nil. Corrige ese error, no la línea genérica.

¿Importa el orden de las líneas ensure?

Sí, cuando los resources dependen unos de otros: inicia un resource después de su framework, sus librerías y cualquier resource cuyos exports llame (la documentación de ox_inventory lista un orden de arranque por este motivo).