Configuração

Todas as opções ficam em shared/config/general.lua.

Armazenamento

Config.Storage = 'json'   -- 'json' grava em data/zones.json | 'db' usa oxmysql

Consulte a Installation para ver a tabela de banco de dados criada automaticamente.

Limites anti-exploit

O servidor valida cada salvamento contra esses limites e rejeita ou ajusta qualquer valor acima deles. Reduza-os para servidores mais rigorosos.

Config.Limits = {
    maxZones     = 100,   -- total de zonas no servidor
    maxPoints    = 64,    -- pontos por zona
    maxJobs      = 40,    -- empregos por zona
    maxWeapons   = 250,   -- entradas nas listas de armas permitidas/bloqueadas
    maxLabelLen  = 64,    -- máximo de caracteres no nome de uma zona
    saveCooldown = 1000,  -- ms entre salvamentos por jogador
}

Intervalo de verificação

Com que frequência (ms) o cliente reavalia em quais zonas o jogador está dentro.

Config.CheckInterval = 300

HUD dentro da zona

O selo de vidro que aparece enquanto estiver dentro de uma zona. Se ele aparece ou não é decidido por zona através da regra showHud — isso apenas controla onde ele fica posicionado e o seu título.

Config.Hud = {
    -- um dos 9 pontos de ancoragem:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = usa o próprio nome da zona
}

Marcador de solo

Desenhado enquanto uma zona com groundMarker = true estiver ativa.

Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

Efeitos de entrada / saída

Polimento global aplicado sobre as regras por zona — um flash colorido na tela e um som de interface ao entrar e sair.

Config.Effects = {
    enabled    = true,
    flash      = true,                 -- flash colorido na tela via NUI
    sound      = true,                 -- blip de interface ao entrar / sair
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

Notificações

Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'

• auto — usa a notificação do framework detectado.
• ox — força as notificações do ox_lib.
• framework — usa o sistema próprio do framework.
• custom — chama o seu próprio gancho (hook) em client/editable.lua.

Inventário (fonte da lista de armas)

O seletor de armas puxa a lista de armas e seus ícones reais diretamente do seu inventário, para que os jogadores vejam exatamente as imagens que possuem na mochila.

Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- sobrescreve o nome do resource se renomeado
Config.InventoryImagePath = nil    -- sobrescreve o caminho base da imagem, ex: 'nui://my_inv/html/images/'

O auto detecta ox_inventory, qb-inventory, esx_inventory, tgiann-inventory ou codem-inventory. WEAPON_UNARMED está sempre selecionável.

Regras padrão

Config.DefaultRules é o conjunto de regras aplicado a cada zona nova. Consulte Zone Rules para ver o que cada chave faz.