Guías · Actualizada 2026-10-04

Cómo instalar un script de FiveM en QBCore o Qbox

Instalar un script de FiveM no es difícil, pero un paso fuera de orden basta para que no arranque. Esta guía sigue el camino de un script comprado en Tebex (con escrow de Cfx.re) en un servidor QBCore o Qbox. Para un script gratis y abierto es igual, sin la parte de la licencia.

Antes de empezar

• Un servidor FiveM funcionando (FXServer, normalmente con txAdmin).
• Acceso a la carpeta del servidor: la que tiene el server.cfg y la carpeta resources.
• La documentación del script a mano: ahí dice qué necesita (por ejemplo ox_lib y oxmysql) y qué items trae. Las de nuestros scripts están en Documentación.

1. Descarga el script desde Cfx.re

Al pagar en Tebex, el script se asigna a tu cuenta de Cfx.re. Entra a portal.cfx.re, busca la sección Granted Assets y descarga el archivo. Cada vez que el creador saca una versión nueva, la descargas de ese mismo lugar.

2. La licencia del servidor tiene que ser de la misma cuenta

Los scripts con escrow solo arrancan si la clave de licencia del servidor (sv_licenseKey en tu server.cfg) se creó con la misma cuenta de Cfx.re que compró el script. Si no coincide, la consola muestra You lack the required entitlement y el script no arranca. Más detalles en Qué es el escrow de FiveM.

3. Copia la carpeta a resources

Descomprime el archivo y copia la carpeta del script dentro de resources (o de una subcarpeta tuya, como resources/[rolo]).

Revisa que el archivo fxmanifest.lua quede directamente dentro de la carpeta del script. Un error muy común es terminar con resources/mi_script/mi_script/fxmanifest.lua: así el servidor no lo encuentra.

4. Añádelo al server.cfg en el orden correcto

Cada script arranca con una línea ensure:

ensure oxmysql
ensure ox_lib
ensure qb-core
# ...tu inventario, target y demás dependencias...
ensure rolo_mechanic

La regla es simple: las dependencias primero. Si un script usa ox_lib y arranca antes que él, verás errores de exports que no existen.

5. Items e imágenes

Si el script usa items, hay que darlos de alta en tu inventario:

• qb-core / Qbox con qb-inventory o qs-inventory: en la lista de items compartidos del framework.
• ox_inventory / origen_inventory: en su archivo de items.

Copia también las imágenes de los items a la carpeta de imágenes de tu inventario. Nuestros scripts traen todo listo en la carpeta items/: las definiciones para cada inventario y un PNG para cada item.

6. Base de datos

Muchos scripts crean sus tablas solos la primera vez que arrancan. Si el script trae un install.sql, ejecútalo en tu base de datos (HeidiSQL o phpMyAdmin) cuando la documentación lo pida.

7. Configura y reinicia

Abre config.lua y ajusta trabajos, permisos y opciones. Las claves privadas (webhooks de Discord, API keys) nunca van en config.lua: en nuestros scripts van en config_server.lua, que solo lee el servidor.

Reinicia el servidor y mira la consola. Si el script imprime su mensaje de inicio sin errores rojos, ya está.

Errores comunes

¿Te atascaste con uno de nuestros scripts? Escríbenos en Discord con el nombre del script, tu framework y el error de la consola.