Skip to main content

config/config.lua

Main Settings

boolean
default:"false"
Shows polyzones and debug zones in-game. Leave false on production servers.
boolean
default:"false"
Disables minigames so you can walk through the full heist flow for testing.
number
default:"180"
Minutes until the casino resets after a completed robbery.
number
default:"38"
Key code for drawtext interactions (38 = [E]).
vector3
default:"vec3(0.8, 0.8, 2)"
Size of drawtext interaction zones.
number
default:"5"
Length of the office computer password (built from employee puzzle + office codes).
number
default:"100"
Number of names on the employee clipboard list.
boolean
default:"false"
Skips the employee name puzzle.
boolean
default:"false"
Disables puzzles that require two players. Set true to test or run the heist solo.
boolean
default:"false"
Disables the animal combination puzzle.
boolean
default:"false"
Disables penthouse loot and related steps.
boolean
default:"false"
Disables the DUI on the manager office computer.
boolean
default:"false"
Disables metal detector props.
boolean
default:"false"
Disables particle effects during the robbery.
boolean
default:"true"
Disables client-side explosions. Set false only if your anticheat allows explosion events.
number
default:"2000"
Milliseconds between staggered C4 detonations.
boolean
default:"false"
Disables laser damage in vault areas (requires mka-lasers).
boolean
default:"false"
Prevents weapon removal during the heist. Enable only if you use a weapon wheel resource.
table
default:"{}"
Door indices from Config.DoorList to unlock when the robbery starts.
number
default:"20"
How many times smoke grenades are thrown in sequence.
number
default:"10000"
Milliseconds between smoke throws.
boolean
default:"true"
Spawn networked props on the server. Set false for client-side spawning.
boolean
default:"true"
Spawn networked peds on the server. Set false for client-side spawning.
table
default:"{\"police\"}"
Jobs counted as police for dispatch and MinimumPolice.
number
default:"0"
Minimum police online to start. Set 0 to disable.
table
Minimum players within radius to start.
Set amount to 0 to disable.
boolean
default:"true"
Requires a bag item to loot trolleys.

Cooldowns & Limits

number
default:"0"
Per-player cooldown in minutes after completing the heist. 0 disables.
number
default:"0"
Max heists per server restart. 0 disables.
number
default:"0"
Max heists per player per restart. 0 disables.

Strike System

number
default:"12"
Maximum trolleys that can spawn (actual count depends on approach and strikes).
number
default:"8"
Strike limit before silent-approach rewards are reduced.
number
default:"4"
(Silent only) Trolleys removed when the strike limit is reached.
number
default:"8"
(Loud only) Fixed number of trolleys that spawn.

Skill System

boolean
default:"false"
Requires a minimum criminal level from a bridge-integrated XP system before starting.
number
default:"20"
Minimum level when SkillSystem is true.

Dispatch

string
default:"\"Casino Heist\""
Dispatch alert title.
string
default:"\"The casino is being robbed\""
Dispatch message body.
string
default:"\"10-70\""
Dispatch radio code.
number
default:"5"
Alert duration in seconds (not all dispatch systems support this).
table
Map blip for the alert.
table
When dispatch fires (enable one step flag besides Loud / Silent as documented in config comments).

Codes & Labels

table
default:"{min = 10000, max = 99999}"
Random code range for the side office computer.
table
default:"{min = 10000, max = 99999}"
Random code range for the main office computer.
table
UI strings for password prompts, animal puzzle, and hidden word combination inputs. Edit in config/config.lua under Labels.

Puzzle Settings

boolean
default:"true"
Shows the first letter of each hidden puzzle word.
boolean
default:"false"
Shows the last letter of each hidden puzzle word.
boolean
default:"true"
Hides one clue in the secret combination puzzle.

Bonus Items

boolean
default:"false"
Enables bonus item drops at the end of the heist.
number
default:"15"
Percent chance any bonus item is awarded.
number
default:"1"
Number of items rolled from Bonus.Items.
table
Possible bonus items with Name, Chance, and Amount range.

Evidence & Stress

boolean
default:"true"
Enables fingerprint evidence at the scene.
number
default:"50"
Chance (%) to drop fingerprint evidence.
boolean
default:"true"
Applies stress when a minigame fails.
number
default:"90"
Chance (%) to apply stress on fail.
table
default:"{min = 1, max = 3}"
Stress amount range per failure.

Durations

Animation and progress timings (milliseconds unless noted):
number
default:"5"
Seconds for multi-player fusebox sync.
number
default:"2500"
Default notification duration.
number
default:"6000"
Staircase interaction duration.
number
default:"6000"
Desk search duration.
number
default:"6000"
Keypad interaction duration.
number
default:"6000"
Computer interaction duration.
number
default:"6000"
Safe interaction duration.
number
default:"6000"
Smoke grenade step duration.
number
default:"6000"
Fusebox interaction duration.
number
default:"6000"
Drilling step duration.
number
default:"3000"
Laptop placement duration.
number
default:"6000"
Vault computer puzzle duration.
number
default:"2000"
Generic prop interaction duration.

Config.Items

Maps logical item keys to inventory item names. Change values here if your server uses different item names.
Break chances on use are set in Config.ItemsBreak.

Rewards

Trolley payouts use Config.Rewardcash, Config.Rewardgold, and Config.Rewarddiamond. Each table supports ObtainPerPickup, Cash, Item, StackAmount, and optional ItemInfo — same pattern as other Project X heists. Painting and gem loot use separate reward tables in config; trolley coordinates are defined in config and do not need to be duplicated in docs.

Logs

Configured in config/logs.lua.
boolean
default:"false"
Enables Discord / Fivemanage logging.
string
default:"\"\""
Webhook URL or Fivemanage / Fivemerr API key.
string
default:"\"default\""
Fivemanage dataset name.