Docs

kyoGangTerritories

Configuration

Framework and money

Config.Framework = 'esx'       -- 'esx' | 'qb' | 'qbox' | 'auto'
Config.Inventory = 'auto'      -- 'auto' | 'ox_inventory' | 'framework'

-- QBCore / Qbox only: what each ESX account name is on your server
Config.QBMoney = {
    money = 'cash',
    bank = 'bank',
    black_money = 'crypto',    -- or 'item:black_money' for an inventory item
}

Config.AutoInstallSQL = true
  • auto (framework) detects whatever is running: Qbox, then ESX, then QBCore.
  • auto (inventory) uses ox_inventory when it is running, otherwise the framework inventory.
  • The script uses ESX account names internally (money, bank, black_money). On QBCore / Qbox, Config.QBMoney says what each one is.

Conquest rules

Config.PoliceJobName = 'police'
Config.RequiredCops = 0           -- on-duty police needed to start a conquest
Config.RequiredGangMembers = 1    -- online members of the same gang needed

Config.RequiredItems = {          -- consumed from the player who starts it
    { name = 'bolsa_meta', count = 20 },
    { name = 'bolsa_marihuana', count = 20 },
    { name = 'bolsa_opio', count = 20 },
}

Config.CaptureTime = 300           -- seconds the zone must be held
Config.DefaultRewardAmount = 20000 -- default reward per participant
Config.RewardAccount = 'black_money'
Config.CooldownHours = 24          -- protection after a capture

Note: change Config.RequiredItems to items that exist on your server, or leave it empty ({}) to require nothing.

Notifications and dispatch

Config.NotifySystem = 'kyoNotify'  -- 'default' | 'kyoNotify' | 'okok_notify' | 'vms_notify'
Config.DispatchSystem = 'default'  -- 'default' | 'cd_dispatch' | 'origen_police'

Gang panel

Config.GangPanelCommand = 'territory'

Passive income

Config.Income = {
    Enabled = true,
    IntervalMinutes = 30,
    AmountPerZone = 5000,
    MaxStored = 150000,       -- treasury cap (0 = no limit)
    CollectMinGrade = 0,      -- minimum job grade allowed to collect
    Account = 'black_money',  -- account the collected money goes to
    NotifyMembers = false,    -- notify online members on every payout
}

Attack alerts

Config.AttackAlerts = {
    Enabled = true,
    BlipSeconds = 120,   -- how long the alert blip stays on the map
}

Contested zones

Config.Contest = {
    Enabled = true,      -- rival members alive inside stop the timer (requires OneSync)
}

Conquest window

Config.Schedule = {
    Enabled = false,
    StartHour = 18,
    EndHour = 24,        -- can wrap past midnight: 20 → 2 means 20:00 to 02:00
}

Server local time. Outside these hours no new conquest can start.

Treasury deposits

Config.Treasury = {
    AllowDeposits = true,
    DepositAccount = 'black_money',
    MinDeposit = 1000,
    LedgerSize = 25,     -- movements shown in the gang panel
}

Deposits ignore Income.MaxStored.

Upgrades

Config.Upgrades = {
    Enabled = true,
    BuyMinGrade = 0,
    List = {
        income  = { Prices = { 40000, 90000, 180000 },  PerLevel = 0.25 },  -- +25 % income
        vault   = { Prices = { 25000, 60000, 120000 },  PerLevel = 75000 }, -- +$75k capacity
        fortify = { Prices = { 50000, 110000, 220000 }, PerLevel = 0.15 },  -- +15 % capture time for rivals
        shield  = { Prices = { 35000, 80000, 160000 },  PerLevel = 4 },     -- +4 h protection
    },
}

Prices[n] is the cost of level n. Add or remove prices to change the maximum level.

Zone editor

Config.ZoneEditor = {
    MaxPoints = 64,           -- max vertices per zone
    MaxDistance = 250.0,      -- how far the aim laser reaches (metres)
    WallHeight = 25.0,        -- height of the preview walls
    DefaultProtectHours = nil -- nil = Config.CooldownHours for new zones
}

Config.FreeZoneColor = 4      -- map colour of free zones (4 = white, 40 = dark grey)

settings.json

Language and webhooks are saved in settings.json, and are normally changed from Admin panel > Settings:

{
    "locale": "en",
    "webhooks": {
        "AdminLogs": "",
        "Started": "",
        "Finished": "",
        "Failed": ""
    }
}

Languages: en, es, de, pt.