Configuration

All server-side settings live in config/main.lua. Per-zone behaviour (weapons, vehicles, blips, job whitelist) is set in the admin UI and stored in data/zones.json.

Open the file in an editor and change only what you need — this page is the short version.

Setup#

setup = {
    debug = 1,           -- 1 = errors only; higher = more console output
    checkVersion = true,
    notify = 'auto',     -- or ox_lib, lt-ui, esx_notify, qb-notify, etc.
},

Supported setup.notify values: auto, ox_lib, lt-ui, esx_notify, okokNotify, pNotify, mythic_notify, brutal_notify, wasabi_notify, origen_notify, lation_ui, qb-notify. With auto, the first running compatible resource is used.

General#

Notifications#

notifications = {
    enabled = true,
    customNotifications = true,
},

Per-zone Notification in the editor still controls whether that zone triggers enter/leave messages at all.

Safezone performance#

These values tune how often the client scans entities near zones. Lower milliseconds = more responsive, slightly heavier.

safezone = {
    healIntervalMs = 5000,
    zoneScanMargin = 80.0,
    vehicleScanMs = 1000,
    pedCollisionMs = 50,
    vehicleCollisionMs = 50,
},

If you run many large zones and notice client load, raise the *Ms values slightly instead of lowering them.

Ghost mode#

UI — safezone warning#

When notifications.customNotifications = true, players see this NUI banner while inside a zone (zone name on screen).

ui = {
    safezoneWarning = {
        position = 'bottom',       -- 'bottom' or 'top'
        shadowsAndGlows = true,
        shadow = 'rgba(87,166,255,0.5)',
        accent = '#57A6FF',
        logoGradient = { '#57A6FF', '#4c94e7' },
        logoBorder = '0.75px solid #57A6FF',
        textColor = 'rgba(255,255,255,0.85)',
    },
},

Preview & zone borders#

Freecam editor preview and in-game Show Zone Borders drawing use preview in config:

preview = {
    validColour = vec3(0, 255, 0),
    invalidColour = vec3(255, 0, 0),
    wallAlphaPreview = 50,
    lineAlphaPreview = 50,
    wallWidth = 0.3,
    maxDistance = 350.0,
    wallAlphaInGame = 15,
    lineAlphaInGame = 15,
},

Borders only show when the zone has Show Zone Borders enabled and you are within preview.maxDistance.

Disarming players#

When Disable Firearms is on, the script calls disarmPlayer from config:

disarmPlayer = function()
    local inventory = LT.Inventory.GetResource()
    if inventory == 'ox_inventory' then
        TriggerEvent('ox_inventory:disarm', PlayerId())
    else
        SetCurrentPedWeapon(cache.ped, `WEAPON_UNARMED`, true)
    end
end,

Extend this if you use another inventory — match the pattern in config/main.lua comments.

Freecam (editor)#

freecam = {
    speed = 1.15,
    fov = 50.0,
    lookSens = 5.0,
    raycastDist = 500.0,
    thicknessStep = 1.0,
    thicknessMin = 1.0,
    thicknessMax = 100.0,
    baseZStep = 0.5,
},

Controls how the point-placement camera feels. Most servers can leave defaults; see Editor for in-game keys.

Per-zone settings (admin UI)#

Each zone stores its own rules. Whitelisted jobs (see below) skip restrictions for that zone.

Combat & weapons#

Movement#

Player#

Vehicles#

Whitelisted players driving their own vehicle are exempt from vehicle limits.

Map#

Job whitelist#

Enable Job Whitelist, add jobs with a minimum grade. Matching players are treated as whitelisted inside that zone — combat, movement, and vehicle rules do not apply to them (their own vehicle is also exempt from vehicle limits).

Job names must match your framework (police, ambulance, etc.).

Locales#

Set locale = 'en' (or another code). Edit strings in locales/*.json. UI labels for zone settings live under ui.settings in those files.