Configuration

Configuration

All settings are stored in config.lua.

---

Core Modes

Framework

Config.Framework = 'auto'  -- 'auto' | 'esx' | 'qb'

• auto – detect es_extended or qb-core / qbx-core automatically.

• esx / qb – force a specific framework.

---

Inventory

Config.Inventory = 'auto'  -- 'auto' | 'ox' | 'qb'

• auto – detect ox_inventory or qb-inventory.

• ox – force ox_inventory.

• qb – force qb-inventory.

The inventory bridge is used for all item checks, adding and removing items.

---

Locale & Notify

Config.Locale      = 'en'
Config.Notify      = 'okok'    -- 'esx' | 'okok'
Config.NotifyTitle = 'Obavijest'

• Config.Locale – which language to use from locale/locales.lua ('en', 'hr', or your custom).

• Config.Notify:

  • esx – ESX notifications (if ESX is running).

  • okok – okokNotify resource (if started).

• Config.NotifyTitle – title used for okok/notify providers that support a title.

---

Discord Logging

Config.Discord = {
  Webhook = ''
}

• Set Webhook to your Discord webhook URL to enable:

  • Robbery start embeds

  • Loot embeds If empty, Discord logging is disabled.

---

Minigame Bridge

Config.Minigame = {
  provider = 'boii_wire',       -- 'boii_wire' | 'psui_circle' | 'ox_skill' | 't3_lockpick' | 'fallback'
  resource = 'boii_minigames',  -- resource name that provides the minigame
  options  = {
    -- boii_minigames:
    style = 'default',
    timer = 60000,

    -- ps-ui:
    circles = 3,
    time    = 20,

    -- ox_lib (skillCheck):
    difficulties = { 'easy', 'easy', 'medium' },
    keys         = { 'W', 'A', 'S', 'D' },

    -- t3_lockpick:
    -- item       = 'lockpick',
    -- difficulty = 0.95,
    -- pins       = 12,
  }
}

• provider – which minigame implementation to use.

• resource – which resource to call exports from.

• options – provider-specific configuration.

If the provider or resource is missing, the script will fall back to a simple timed progress bar using ox_lib (if available) or Wait.

---

Noise / Alarm System

Config.Noise = {
  Threshold    = 150,
  GainRun      = 10,
  GainWalk     = 1.5,
  GainAction   = 5,
  Decay        = 0.5,
  TickInterval = 50,
}

• Threshold – noise level at which the alarm triggers.

• GainRun – noise gained while running/sprinting.

• GainWalk – noise gained while walking.

• GainAction – noise gained on actions (e.g. shooting).

• Decay – how fast noise decreases when crouched.

• TickInterval – update interval in milliseconds.

A HUD bar is drawn on the client showing current noise percentage.

---

Robbery Start & Basic Settings

Config.StartRadius  = 1.5
Config.RequiredItem = 'lockpick'
Config.Cooldown     = 10  -- minutes

• StartRadius – distance from a StartLocation where the prompt appears.

• RequiredItem – item name required to start a robbery (must exist in your inventory system).

• Cooldown – per-player cooldown between attempts (in minutes).

---

Houses (Interiors)

Config.Houses = {
  {
    ipl    = 'apa_v_mp_h_01_a',
    coord  = vector3(-786.8663, 315.7642, 217.6385),
    chance = 10,
  },
  {
    ipl    = 'apa_v_mp_h_01_c',
    coord  = vector3(-786.9563, 315.6229, 187.9136),
    chance = 20,
  },
  -- ...
}

Each house entry:

• ipl – name of the IPL / interior (string).

• coord – vector3 coordinates inside the apartment.

• chance – weight for random selection (higher value = more likely).

The script picks one house based on these weights when a robbery starts.

---

Police Settings

Config.Police = {
  minOnline = 0,
  jobName   = 'police',
}

• minOnline – minimum number of police online to allow robberies and alarms.

• jobName – job name used to count police players (ESX / QB job).

---

Dispatch Bridge

-- 'lb-tablet' -> LB Tablet dispatch
-- 'tk'        -> tk_dispatch
-- 'ps'        -> ps-dispatch
-- 'next'      -> Next Scripts dispatch (resource 'dispatch')
-- 'none'      -> no dispatch

Config.Dispatch = 'lb-tablet'

Supported values:

• 'lb-tablet' – LB Tablet dispatch.

• 'tk' – tk_dispatch.

• 'ps' – ps-dispatch.

• 'next' – Next Scripts dispatch.

• 'none' – disable dispatch entirely.

Each dispatch adapter uses its own API and passes translated titles/descriptions based on locale/locales.lua.

---

Loot Configuration

Config.Loot = {
  defaultRadius = 0.3,
  zones = {
    ['apa_v_mp_h_01_a'] = {
      {
        coords = vector3(-789.63, 321.68, 217.13),
        radius = 1.0,
        items  = {
          { name = 'firstaid',        chance = 60, min = 1, max = 1 },
          { name = 'firstaid',        chance = 30, min = 1, max = 3 },
          { name = 'weapon_appistol', chance = 10, min = 1, max = 1 },
        },
      },
      -- more spots...
    },

    ['vanilla_3'] = {
      -- loot spots for that interior...
    },
  }
}

For each IPL/interior (zones['iplName']):

• Each table entry is a loot zone:

  • coords – vector3 of the spot.

  • radius – (optional) radius for target interaction.

    • If omitted, Config.Loot.defaultRadius is used.

  • items – list of possible loot items:

    • name – item name.

    • chance – relative weight for this item (all chances are normalized per zone).

    • min / max – random quantity range if this item is selected.

Server picks one item based on chance values and adds it to the player.

---

Start Locations

Config.StartLocations = {
  vector3(-1112.25, -1578.4, 7.7),
  vector3(-1114.34, -1579.47, 7.7),
  -- ...
}

• Each vector3 is a world position where the robbery can be started.

• If a player is within Config.StartRadius of any point, the E to start help text appears.

---

Locales

Locales are configured in locale/locales.lua:

• Locales['en'] – English strings.

• Locales['hr'] – Croatian strings.

The helper L(key, ...) reads from Config.Locale.

You can:

• Change existing texts.

• Add new language tables (e.g. Locales['de'] = { ... }).

• Set Config.Locale = 'de' to use your language.