Configuration

Framework, inventory, progress, defaults, and data persistence.

All gameplay settings live in config.lua. Robbery locations themselves are saved in JSON via the admin UI.

Framework & inventory

Config.Framework.type = 'esx'   -- or 'qb'
Config.Inventory.system = 'esx'  -- 'qb' | 'qs-inventory' | 'ox_inventory'

-- QBCore black money item (default markedbills + worth metadata)
Config.QBCore.blackMoneyItem = 'markedbills'
Config.QBCore.inventoryBackend = 'auto'

Default robbery values

New robberies inherit these until changed per location in the creator:

Config.Defaults = {
  minCops = 0,
  alertJob = 'police',
  duration = 300,
  cooldown = 1800,
  zoneRadius = 2.0,
  interactionKey = 38,
  interactionDistance = 2.0,
}

Progress & minigames

Config.Progress.type = 'minigame'  -- or 'linear'
Config.Progress.minigame.provider = 'datacrack'  -- datacrack | nc-memory | bl_ui | custom
Config.Progress.cancelOnMovement = true
Config.Progress.maxMovementDistance = 5.0

Set type = 'linear' for a standard timer only. With minigames, install the matching resource and ensure it starts before AlpyRobbery.

Data file

Config.Data.robberiesFile = 'data/robberies.json'
Config.Data.autoSave = true
Config.Data.createBackup = true