⚙️ Configuration

Framework Setup

Config.Framework = "auto"    -- Options: "esx", "qbcore", "auto"

💡 Auto-detection works in 99% of cases. Only change if you experience issues.

Basic Settings

Config.Locale = 'en'         -- Available: 'en', 'fr', 'de', 'es', 'nl', 'pl', 'it', 'pt' and 'custom'
Config.UIMethod = "both"     -- Options: "command", "item", "both"
Config.ItemName = "zone_tablet" -- Item name in inventory (must be added to your inventory!)

Commands

Config.Commands = {
    OpenUI = "zonemenu",     -- Command to open tablet
    SetZone = "setzone"      -- Quick zone creation
}

Zone Limits

Config.Limits = {
    MaxZonesPerOfficer = 3,  -- Max zones per player
    MinRadius = 10,          -- Minimum radius (meters)
    MaxRadius = 500,         -- Maximum radius (meters)
    MinDuration = 1,         -- Minimum duration (minutes)
    MaxDuration = 60         -- Maximum duration (minutes)
}

Job Permissions

Configure which jobs can access the system:

Config.Jobs = {
    AllowedJobs = {
        ["police"] = {
            enabled = true,
            minimumGrade = 0,                               -- Required job grade
            jobLabel = "Police Officer",                    -- Display name
            canSeeZonesFrom = {"police", "ambulance"},      -- Which jobs' zones to see
            canEditZonesFrom = {"police"},                  -- Which jobs' zones to edit
            editTimeLimit = 15                              -- Edit time limit (minutes)
        },
        ["ambulance"] = {
            enabled = true,
            minimumGrade = 0,
            jobLabel = "Paramedic",
            canSeeZonesFrom = {"ambulance", "police"},
            canEditZonesFrom = {"ambulance"},
            editTimeLimit = 15
        }
    }
}

Adding New Jobs

To add a new job (e.g., "sheriff"):

["sheriff"] = {
    enabled = true,
    minimumGrade = 0,
    jobLabel = "Sheriff Deputy",
    canSeeZonesFrom = {"sheriff", "police"},
    canEditZonesFrom = {"sheriff"},
    editTimeLimit = 15
}

Notifications

Config.Notifications = {
    System = "ox_lib",       -- See integrations for options
    Duration = 5000,         -- Duration in milliseconds
    ESX = {
        UseAdvanced = false  -- Use ESX advanced notifications
    }
}

Discord Integration

Config.Discord = {
    Enabled = false,                    -- Enable Discord logging
    WebhookURL = "",                   -- Your webhook URL
    BotName = "Zone System",           -- Bot display name
}

Performance Settings

Config.Performance = {
    UpdateInterval = 3000,      -- UI update interval (ms)
    JobCheckInterval = 30000    -- Job check interval (ms)
}

⚠️ Lower intervals = higher performance impact.

UI Customization

Config.UI = {
    DefaultTheme = "dark",          -- Default theme: "dark", "light"
    AllowThemeChange = true,        -- Allow users to change theme
    SaveThemePreference = true      -- Save user theme choice
}

Tablet Prop

Config.TabletProp = {
    Enabled = true,                 -- Show physical tablet prop
    PropName = "prop_cs_tablet",    -- GTA prop model
    BoneIndex = 60309,              -- Attachment bone
    PropPos = vector3(0.03, 0.002, -0.0),
    PropRot = vector3(10.0, 160.0, 0.0)
}