Skip to content

Instalación

Installation

1. Dependencies

Instala e inicia ox_lib antes de este recurso. Si planeas usar almacenamiento en base de datos, oxmysql también debe estar en ejecución.

2. Coloca el recurso

Coloca bupa-safezonecreator en tu carpeta de recursos (por ejemplo, dentro de una carpeta de categoría [BUPA]) y agrégalo a tu server.cfg.

3. server.cfg — orden de inicio

ox_lib (y oxmysql, si se usa) deben iniciarse antes del recurso.

server.cfg
ensure ox_lib
ensure oxmysql            # solo si usas Storage = 'db'
ensure bupa-safezonecreator

4. Acceso de administrador

La apertura del creador está restringida. Durante las pruebas está abierto para todos — bloquéalo antes de abrir tu servidor al público.

shared/config/general.lua
Config.AdminOnly = false   -- TODO: cámbialo a true antes del lanzamiento (actualmente abierto para todos)
Config.AdminAce  = 'bupa.safezone'
Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.CustomAdmin = false -- true = usa tu propio IsPlayerAdmin() en server/editable.lua

Una vez que AdminOnly = true, un jugador pasa el filtro si cualquiera de estas condiciones es verdadera:

  • Posee el permiso ACE — otórgalo con:
server.cfg
  add_ace group.admin bupa.safezone allow
  
  • Su grupo de framework está en Config.AdminGroups (grupo de ESX, nombre de trabajo de QB-Core / HasPermission('admin'), nombre de trabajo de QBox).
  • Config.CustomAdmin = true y tu función Editable.isAdmin(src) en server/editable.lua devuelve true.

Config.AdminOnly viene configurado como false por defecto para que puedas probarlo de inmediato. Cámbialo a true antes del lanzamiento, o cualquier persona podrá abrir el creador.

5. Almacenamiento — JSON o base de datos

shared/config/general.lua
Config.Storage = 'json'   -- 'json' | 'db'
  • json (por defecto) — las zonas se guardan en data/zones.json dentro del recurso. Cero configuración.
  • db — las zonas se almacenan en oxmysql. La tabla se crea automáticamente en el primer inicio; no necesitas importar ningún SQL:
auto-created table
CREATE TABLE IF NOT EXISTS bupa_safezones (
    id   VARCHAR(64) PRIMARY KEY,
    data LONGTEXT
);

6. Idioma

El idioma se establece de forma global mediante la convar de localización de ox_lib. Agrégala al server.cfg:

server.cfg
setr ox:locale "tr"

El inglés es el idioma predeterminado (fallback) para cualquier clave faltante. Consulta Localization para ver la lista completa de idiomas incluidos.