RexHost — Hosting y VPS
Todas las guías
FiveMBásico

Instala cualquier recurso en FiveM sin romper el arranque

resources, fxmanifest, orden de carga en server.cfg y cómo leer los errores de la consola.

9 min de lectura · 9 pasos

Antes de empezar

  • Un servidor de FiveM ya encendido al menos una vez
  • El recurso descomprimido, de una fuente legítima
  • Acceso a la base de datos, si el recurso trae un .sql
  1. Sube el recurso a la carpeta correcta

    Los recursos van en resources/. La carpeta del recurso debe contener directamente el fxmanifest.lua, sin otra carpeta de por medio. Si usas un framework, la convención es agruparlos entre corchetes: [qb], [esx], [standalone], [mapas].

    ❌  resources/[qb]/mi-recurso/mi-recurso-main/fxmanifest.lua
    ✅  resources/[qb]/mi-recurso/fxmanifest.lua

    Descomprimir mal deja la carpeta dentro de la carpeta. Así no arranca, y el error que da la consola no lo explica: solo dice que no encuentra el recurso.

  2. Los corchetes son carpetas de verdad

    Una carpeta entre corchetes es una agrupación: FiveM la recorre y encuentra los recursos de dentro sin que tengas que nombrarlos uno a uno. Puedes arrancar todo el grupo con una sola línea, y es lo que hacen las plantillas de QBCore y ESX.

    server.cfg

    ensure [standalone]
    ensure [qb]     # arranca todos los recursos de dentro
  3. Decláralo en server.cfg con ensure

    Un recurso que no está en server.cfg no existe para el servidor. Se declara con ensure, no con start: ensure lo arranca y, si ya estaba corriendo, lo reinicia. Es el que quieres siempre.

    server.cfg

    ensure mi-recurso
  4. El orden de las líneas es el orden de arranque

    Un recurso que arranca antes que su dependencia falla siempre. El orden correcto es de abajo hacia arriba en la pila: base de datos, biblioteca, framework, inventario, y al final lo tuyo.

    server.cfg

    # 1. Base y bibliotecas
    ensure oxmysql
    ensure ox_lib
    
    # 2. Framework
    ensure qb-core          # o ensure es_extended
    
    # 3. Inventario y objetivo
    ensure ox_inventory
    ensure ox_target
    
    # 4. Grupos del framework
    ensure [qb]
    
    # 5. Lo tuyo, al final
    ensure mi-recurso
  5. Lee el fxmanifest antes de instalar

    El fxmanifest.lua es la ficha técnica del recurso y te dice en treinta segundos si te va a dar problemas. Mira la línea de dependencias y qué archivos carga:

    resources/mi-recurso/fxmanifest.lua

    fx_version 'cerulean'
    game 'gta5'
    lua54 'yes'
    
    shared_scripts {
        '@ox_lib/init.lua',      -- la @ significa: de otro recurso
        'config.lua'
    }
    client_scripts { 'client/*.lua' }
    server_scripts {
        '@oxmysql/lib/MySQL.lua',
        'server/*.lua'
    }
    
    dependencies { 'ox_lib', 'qb-core' }

    Si ves «@ox_lib/init.lua» y no tienes ox_lib instalado, el recurso no va a arrancar por muchas vueltas que le des al server.cfg.

  6. Importa el SQL antes de arrancarlo

    Muchos recursos traen un .sql que crea sus tablas. Impórtalo desde la pestaña Bases de datos del panel antes de arrancar el recurso; si lo dejas para después, el recurso se cae en el primer uso con un error de tabla inexistente.

    phpMyAdmin del panel

    -- Importar → seleccionar el .sql del recurso → Continuar
    -- Si el archivo trae varias sentencias y falla a la mitad,
    -- pégalas en la pestaña SQL de una en una.
  7. Configura antes de reiniciar

    Casi todos traen config.lua o config.json con lo que hay que ajustar: coordenadas, precios, trabajos permitidos, idioma. Léelo entero una vez. La mayoría de los «no funciona» del primer día son un config con el nombre de un trabajo que en tu servidor se llama distinto.

  8. Reinicia y lee la consola

    Reinicia el servidor entero la primera vez —no uses refresh y ensure a mano— y mira la consola. Un recurso sano imprime su nombre al cargar. Si algo falla, el mensaje siguiente dice exactamente qué falta:

    Lo que dice la consolaLo que significa
    Couldn't find resource XNo está en resources/ o tiene carpeta de más
    Failed to load script @X/…Falta el recurso del que depende
    attempt to index a nil value (global 'QBCore')El core no había arrancado todavía: revisa el orden
    Unknown column / Table doesn't existNo importaste el .sql
    script error … citizen:/scripting/luaError dentro del recurso: la línea sale en el mensaje
    No such export getSharedObjectEl recurso espera otra versión de ESX
  9. Recursos pirateados: no, y no por moral

    Además de estar prohibido por nuestra política de uso y por los términos de Cfx.re, los recursos «leakeados» son el vector habitual de puertas traseras: vacían la economía del servidor, se llevan la base de datos completa y dejan un administrador oculto. Si un script de pago aparece gratis en un foro, alguien está cobrando de otra forma.

    Un recurso con código ofuscado que no venga del creador original es una puerta trasera hasta que se demuestre lo contrario. Revisa siempre si tiene llamadas a direcciones externas con PerformHttpRequest.

¿Se te atoró algo?

Escríbenos y lo vemos contigo. Si la duda se repite, la agregamos a esta guía.

Pedir ayuda

¿Todavía no tienes servidor?

QBCore · ESX · vRP · qbox, desde $547 al mes.

Ver planes de FiveM