Skip to content

Конфігурація

Configuration

All options live in shared/config/general.lua.

Storage

shared/config/general.lua
Config.Storage = 'json'   -- 'json' writes data/zones.json | 'db' uses oxmysql

See Installation for the auto-created database table.

Anti-exploit limits

The server validates every save against these caps and rejects or clamps anything over them. Lower them for stricter servers.

shared/config/general.lua
Config.Limits = {
    maxZones     = 100,   -- total zones on the server
    maxPoints    = 64,    -- points per zone
    maxJobs      = 40,    -- jobs per zone
    maxWeapons   = 250,   -- entries in allow/block weapon lists
    maxLabelLen  = 64,    -- max characters in a zone name
    saveCooldown = 1000,  -- ms between saves per player
}

Check interval

How often (ms) the client re-evaluates which zones the player is inside.

shared/config/general.lua
Config.CheckInterval = 300

In-zone HUD

The glass badge that appears while inside a zone. Whether it shows at all is decided per zone by the showHud rule — this only controls where it sits and its title.

shared/config/general.lua
Config.Hud = {
    -- one of 9 anchor points:
    --   top-left     top-center     top-right
    --   middle-left  middle-center  middle-right
    --   bottom-left  bottom-center  bottom-right
    position = 'bottom-center',
    title    = nil,   -- nil = use the zone's own name
}

Ground marker

Drawn while a zone with groundMarker = true is active.

shared/config/general.lua
Config.Marker = {
    type = 1,
    size = { r = 60.0, g = 108.0, b = 240.0, a = 90 },
}

Enter / exit effects

Global polish layered on top of per-zone rules — a coloured screen flash and a frontend sound on enter and exit.

shared/config/general.lua
Config.Effects = {
    enabled    = true,
    flash      = true,                 -- coloured screen flash via the NUI
    sound      = true,                 -- frontend blip on enter / exit
    enterSound = 'CHECKPOINT_NORMAL',
    exitSound  = 'CANCEL',
}

Notifications

shared/config/general.lua
Config.NotifySystem = 'auto'   -- 'auto' | 'ox' | 'framework' | 'custom'
  • auto — use the detected framework's notification.
  • ox — force ox_lib notifications.
  • framework — use the framework's own system.
  • custom — call your own hook in client/editable.lua.

Inventory (weapon list source)

The weapon picker pulls the weapon list and its real icons straight from your inventory, so players see the exact images they have in their bag.

shared/config/general.lua
Config.Inventory         = 'auto'  -- 'auto' | 'ox' | 'qb' | 'esx' | 'tgiann' | 'codem'
Config.InventoryResource = nil     -- override the resource name if renamed
Config.InventoryImagePath = nil    -- override the image base path, e.g. 'nui://my_inv/html/images/'

auto detects ox_inventory, qb-inventory, esx_inventory, tgiann-inventory or codem-inventory. WEAPON_UNARMED is always selectable.

Default rules

Config.DefaultRules is the rule set applied to every brand-new zone. See Zone Rules for what each key does.

PreviousZone RulesNext Discord Logging