Installation

Installation

Requisitos previos

• Servidor FiveM funcionando (QBox, QBCore, ESX o standalone — el framework es opcional).
• ox_lib instalado y funcionando.
• oxmysql instalado y funcionando.

{% hint style="info" %} Opcional: ox_inventory, para que el desarme al entrar sin permiso de armas funcione integrado con tu inventario. {% endhint %}

Paso 1 — Descargar

Descarga el .zip del resource desde tu compra de Tebex/BuiltByBit.

Paso 2 — Ubicación correcta

resources/
└── yei-safezone/
    ├── fxmanifest.lua
    ├── config.lua
    ├── client/ (camera.lua, creator.lua, main.lua, panel.lua)
    ├── server/ (mysql_bridge.lua, main.lua)
    ├── locales/ (en.json, es.json)
    ├── web/ (index.html, assets/app.css, assets/app.js)
    └── sql/install.sql

Paso 3 — Ensure en server.cfg (orden importante)

ensure ox_lib
ensure oxmysql
ensure yei-safezone

{% hint style="warning" %} ox_lib y oxmysql deben cargar antes que yei-safezone — son dependencias declaradas en el fxmanifest. {% endhint %}

Paso 4 — Base de datos

No necesitas correr ningún .sql manualmente. El bridge crea la tabla yei_safezones solo, reintentando hasta 15 veces si la base de datos aún no está lista. sql/install.sql queda como referencia opcional.

Paso 5 — Permiso ACE (obligatorio)

add_ace group.admin yei.safezone allow
add_principal identifier.license:TU_LICENCIA group.admin

O directo a una license:

add_ace identifier.license:TU_LICENCIA yei.safezone allow

Este permiso se revisa en el comando y en cada acción del panel.

Paso 6 — Configurar el script

Ajusta config.lua: permiso, comando, framework, TextUI, íconos, controles bloqueables, invencibilidad y Discord logging. Ver Configuration.

Paso 7 — Reiniciar el servidor

Reinicia completamente ox_lib, oxmysql y yei-safezone.

Errores comunes