Installation

description: Install yei-starterpack and its required database dependency.

Installation

Requisitos previos

• Servidor FiveM funcionando (QBox, QBCore, ESX o standalone).
• oxmysql instalado y funcionando.

{% hint style="info" %} Opcional pero recomendado: ox_lib y ox_target para la mejor experiencia de notificaciones e interacción. {% endhint %}

Paso 1 — Descargar

Descarga el .zip del resource desde tu compra de Tebex/BuiltByBit o tu link de descarga entregado.

Paso 2 — Ubicación correcta

Descomprime el contenido dentro de tu carpeta resources. La estructura final debe verse así:

resources/
└── [standalone]/
    └── yei-starterpack/
        ├── fxmanifest.lua
        ├── client/
        │   └── main.lua
        ├── server/
        │   └── main.lua
        ├── shared/
        │   ├── config.lua
        │   └── framework.lua
        └── web/
            ├── index.html
            ├── style.css
            └── app.js

{% hint style="warning" %} Si ya tenías una versión anterior instalada, borra la carpeta vieja completa antes de copiar la nueva — evita mezclar archivos de versiones distintas. {% endhint %}

Paso 3 — Ensure en server.cfg

Agrega estas líneas en tu server.cfg. oxmysql debe cargar antes que yei-starterpack:

ensure oxmysql
ensure yei-starterpack

Paso 4 — Instalación de base de datos

No necesitas correr ningún .sql manualmente. El resource crea automáticamente la tabla yei_starterpack_claims la primera vez que arranca, siempre que oxmysql esté conectado correctamente a tu base de datos.

Paso 5 — Permiso de administrador (opcional)

Si quieres poder usar el comando de reseteo (/resetstarterpack), agrega el ACE correspondiente en tu server.cfg:

add_ace group.admin yei-starterpack.admin allow

Cambia group.admin por el grupo o principal que uses para tus staff/admins.

Paso 6 — Configurar el script

Abre shared/config.lua y ajusta framework, NPC, vehículos, recompensas y colores a tu gusto. Ver Configuration para el detalle de cada opción.

Paso 7 — Configurar inventario (si aplica)

Si usas ox_inventory, no necesitas hacer nada extra: el script lo detecta automáticamente. Si usas el inventario nativo de QB/ESX, los ítems se entregan por las funciones del framework detectado.

Paso 8 — Reiniciar el servidor

Reinicia completamente el servidor (o al menos oxmysql y yei-starterpack) para que todos los cambios tomen efecto.

Errores comunes