No se pudo iniciar el recurso: por qué FiveM no iniciará tu script

Ejecutas ensure my_script o inicias el servidor, y la consola imprime:

Couldn't start resource my_script.

Esa línea solo te dice el resultado. La causa está en las líneas arriba de ella. Esta guía lista las causas usuales, en el orden que vale la pena comprobar, y muestra cómo leer la consola para saber cuál tienes.

#Lee las líneas arriba primero

Desplázate hacia arriba desde Couldn't start resource en la consola del servidor, o en la consola en vivo de txAdmin. La línea directamente arriba es casi siempre la razón: una dependencia faltante, un error de análisis con un fichero y número de línea, o un problema de manifest.

Si la consola es demasiado ruidosa, detén el servidor, inicia de nuevo, e inicializa solo el recurso que falla:

ensure my_script

Ahora todo lo que se imprime justo después de ese comando pertenece al recurso.

#1. El recurso no se encuentra

Couldn't find resource my_script.

FiveM busca una carpeta nombrada exactamente my_script en algún lugar bajo resources, y esa carpeta debe contener un fichero nombrado fxmanifest.lua (o el antiguo __resource.lua). Comprueba tres cosas:

• El nombre en server.cfg coincide con el nombre de la carpeta, letra por letra. En un anfitrión Linux, My_Script y my_script son diferentes.
• El fichero de manifest se llama fxmanifest.lua, no fxmanifest.lua.txt (Windows oculta extensiones conocidas) y no fxmanifest (1).lua.
• Ejecuta refresh en la consola del servidor después de añadir una carpeta nueva, luego ensure de nuevo. Un servidor en ejecución no escanea carpetas nuevas hasta que lo hagas.

#2. Carpeta anidada después de descomprimir

Este es el error más común con scripts descargados. Descomprime my_script.zip y terminas con:

resources/
  my_script/
    my_script/
      fxmanifest.lua
      client/
      server/

El manifest está un nivel demasiado profundo, así FiveM ve my_script como una carpeta simple sin manifest. Mueve la carpeta interior hacia arriba así fxmanifest.lua se encuentra directamente adentro de la carpeta que aseguras.

Las carpetas de categoría escritas entre brackets, como [mic], están bien: FiveM las busca. Un recurso dentro de otro recurso no.

#3. Un error de sintaxis Lua al cargar

Error parsing script @my_script/server/main.lua in resource my_script: @my_script/server/main.lua:42: unexpected symbol near 'end'
Couldn't start resource my_script.

El mensaje nombra el fichero y la línea (main.lua:42). Abre esa línea y observa también la de antes: un end faltante, una coma faltante en una tabla, o un carácter perdido de una mala copia y pegado. Arréglalo, luego ensure de nuevo.

Dos causas que se ven como errores de sintaxis pero no lo son:

• El script usa sintaxis de Lua 5.4 (<const>, <close>, división entera) y al manifest le falta lua54 'yes'.
• El fichero fue guardado con una codificación diferente o tiene una BOM. Guárdalo como UTF-8 sin BOM.

#4. Dependencia faltante

Could not find dependency ox_lib for resource my_script.
Couldn't start resource my_script.

El manifest pide otro recurso que no está en tu servidor. Instálalo y mantén su nombre de carpeta exacto. La explicación completa está en Could not find dependency X for resource Y.

#5. Errores de manifest

Un fxmanifest.lua incorrecto detiene el recurso antes de que cualquier script se ejecute. Comprueba:

fx_version 'cerulean'
game 'gta5'

client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

Fallos comunes: un fx_version o game faltante, una coma faltante entre entradas en una lista { }, una ruta de fichero en el manifest que no existe, y una ruta con la dirección de barra incorrida o capitalización. Usa barras diagonales hacia adelante. Si el recurso aún envía un __resource.lua, ver converting __resource.lua to fxmanifest.lua.

#6. Escrow, entitlement y licencia

Los scripts protegidos (escrowed) comprueban que la clave de licencia de tu servidor pertenece a la cuenta de Cfx.re que es dueña del activo. Si no, el recurso se niega a iniciar y la línea arriba dice que careces del entitlement. Es una solución separada: escrow: You lack the required entitlement.

#7. El recurso inicia, luego falla de otra forma

A veces el inicio tiene éxito y el fallo viene un segundo después, de un SCRIPT ERROR en un fichero de script, como un valor nil del framework. Eso ya no es un problema de inicio. Lee la línea de error, encuentra el fichero y el número de línea, y arréglalo. Si el objeto del framework es nil, comienza con la guía de ESX o QBCore.

#Una forma rápida de probar el manifest

Comienza con un recurso de prueba limpio. Crea resources/test_ok/fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

server_script 'server.lua'

y resources/test_ok/server.lua:

print('test_ok started')

Ejecuta refresh luego ensure test_ok. Si eso funciona, tu servidor y rutas están bien, y la falta está dentro del recurso que estás persiguiendo.

#Lista de verificación