Everything lives in config/ and locales/.
File
What it holds
config/main.lua
Debug flag, BucketBase, tablet and standalone job rules, noise, alarms, homeowners, carry, XP, police dispatch, phone, logs.
config/tiers.lua
Per-tier shells, loot chance, required picks, police count and night rules.
config/shells.lua
Per-shell search spots, carry spots, alarm panel, bed and entry offsets.
config/loot.lua
Loot pool, replacement items, carry items and disassemble yields.
config/houses.lua
The listed houses, grouped by area.
locales/en.lua
Player-facing text.
data/layouts.json
Shell layouts saved by the in-city layout commands.
data/admin.json
Overrides saved by the admin menu, applied over the config files on every start.
data/dodge.json and html/img/dodge.*
Dodge's look and contact picture. Replace them with your own.
Main settings#
Key
Default
Description
Config.BucketBase
7300
First routing bucket used for robbery interiors. Move it if another resource uses this range.
Config.Debug
false
Prints, draws target zones and registers the dev commands.
Config.HouseCooldown
2
Minutes before a contract house can be picked again.
Config.RobberyTimeout
35
Minutes before an abandoned robbery is cleaned up.
Config.KeptCarMinutes
15
How long the car left outside is kept before it goes back to the engine's own cleanup.
Config.Night
{ from = 21, to = 5 }
Night hours for night-only tiers. Reads GlobalState.currentTime.
Config.Abandon
enabled, 60.0, 200.0, 60
Once someone has come within arriveDistance of the door, the whole crew being further than distance for seconds ends the job.
Config.AreaHeat
enabled, 3 robberies in 60 minutes
Police get a suspicious person call for the area.
Tablet contracts#
Key
Default
Description
Config.Tablet.resource
glitch-criminaltablet
Tablet resource name.
Config.Tablet.minSearches
2
Searched spots needed before going outside settles the job.
Config.Tablet.autoFinishAfter
180
Seconds with nobody inside before a searched house settles by itself.
Config.Tablet.contact
burglar
Tablet contact that messages the crew.
Config.Tablet.jobs
four jobs
One tablet job per house tier: house_rob, house_rob_apt, house_rob_mid, house_rob_high. Each id must exist in the tablet's job config.
Config.Tablet.tierByRep
four bands
Tier weights by the best tablet REP in the crew.
Config.Tablet.hotTierBump
1
Hot contracts roll one tier higher.
Config.Tablet.luxuryBonus
table
Weights luxury homes up for crews with enough completions of other tablet jobs. Set it to nil to turn it off.
Each area in config/houses.lua registers a tablet contract named <job prefix><area id> once its shell layout has at least minSearches spots.
Houses and tiers# config/tiers.lua defines four tiers.
Tier
Label
lootChance
Picks
minPolice
1
Motel room
1.25
lockpick, advancedlockpick
0
2
Apartment
0.6
lockpick, advancedlockpick
0
3
Family home
0.75
advancedlockpick
1
4
Luxury home
1.05
advancedlockpick
2
Each tier also has shells, lootXp and nightOnly. Config.ShellHeight (400.0) is how far above the front door the shell spawns.
config/houses.lua holds Config.Areas, one entry per area with a label and a list of front door coordinates. The default areas use coordinates from a Sydney-style map. Replace them with doors from your own map.
Getting in#
Key
Default
Description
Config.Breach.doorDistance
2.0
Target reach on the front door.
Config.Breach.lockpick.items
advancedlockpick, lockpick
First one found is used. A tier's picks narrows it down.
Config.Breach.lockpick.breakChance
30 / 10
Percent that the lockpick / advanced lockpick breaks on success.
Config.Breach.lockpick.failBreak
75 / 35
Percent it breaks on failure.
Config.Breach.lockpick.alertOnFail
35
Percent that a failed pick is reported.
Config.Breach.lockpick.game
{ 3, 30, 2 } / { 2, 40, 3 }
Rounds, sweet spot size and max failures passed to StartLockpickGame.
Config.Breach.force.enabled
false
Forcing the door with a crowbar. Off by default.
Config.Breach.force.item
WEAPON_CROWBAR
Item needed when force is on.
Config.Breach.force.alertChance
65
Percent that kicking a door in is reported.
Searching, noise and alarms#
Key
Default
Description
Config.Search.duration
4500
Milliseconds per search.
Config.Search.safeItem
stethoscope
Needed to crack wall safes unless the player has the Safe hands perk.
Config.Noise.enabled
true
Noise meter from 0 to 100.
Config.Noise.quietLevel
3.0
Stealth noise above this fills the meter.
Config.Noise.neighbourChance
50
Percent that a neighbour calls it in at a full meter. Rises by chanceStep (25) for each full meter after that.
Config.Noise.loud
safe = 35, carry = 30, fumble = 45
Meter jumps for loud actions. The server keeps its own copy of these.
Config.Noise.fumbleChance
40
Percent of searches that end in a careful-hands skill check.
Config.SilentCalls
enabled, neighbour 60
Share of police calls that go out without warning the crew.
Config.Alarm.chance
{ 0, 0, 40, 100 }
Alarm chance per tier, in percent.
Config.Alarm.seconds
25
Countdown after the first person walks in. Alarms cannot be disarmed.
Homeowners# Config.Homeowner is off by default (enabled = false). When on, sleeping homeowners appear at night (nightOnly = true) at chance percent per tier. Tier 4 always has the owner home in the daytime (dayAlwaysHome). Awake owners call the police after callDelay (10) seconds unless restrained. From armedTier (1), armedChance (10) percent grab weapon (WEAPON_PISTOL) and fight.
Key
Default
Description
Config.Freelance.enabled
false
Break into any listed house without a contract. No REP or payout, smaller loot.
Config.Standalone.enabled
true
The contact NPC. 'auto' shows him only while the tablet is not running.
Config.Standalone.ped
model, coords, scenario
Where Dodge stands. Change coords for your map.
Config.Standalone.captureFace
false
Photograph Dodge's face once with MugShotBase64. Turn it on for first setup only.
Config.Standalone.queueDelay
{ 60, 240 }
Seconds before he texts the address.
Config.Standalone.minPolice
0
On-duty police needed to get a job.
Config.Standalone.cooldown
2
Minutes between job starts per player.
Config.Standalone.tierByLevel
four bands
Tier weights by Burglary level.
Config.Standalone.payout
item, black_money
type is 'item' or 'cash'. tiers holds min and max per tier. cleanBonus is 0.25.
Config.Standalone.cacheDrops
{ [3] = 'house_rob_mid' }
Crafting cache roll per tier. Empty means none.
Config.Phone.enabled
true
Dodge as an sd-phone contact.
Config.Phone.number
5550137
His number.
Config.Phone.perk
burglary_phone
glitch-xpSystem perk that unlocks his number.
XP, police and loot#
Key
Default
Description
Config.XP.enabled
true
Uses the burglary category in glitch-xpSystem.
Config.XP.finishBonus
{ 24, 27, 30, 36 }
XP per tier for finishing a contract house.
Config.TierPerks.enabled
true
A tier is only handed out to someone who owns its Burglary perk.
Config.TabletRep
four ranges
Tablet REP per tier.
Config.Police.jobType
leo
Job type that counts as police.
Config.Police.jobs
six names
Police job names.
Config.Dispatch.system
auto
First of ps-dispatch, cd_dispatch, tk_dispatch, lb-tablet, else builtin.
Config.Carry.takeTime
{ 12000, 18000 }
Milliseconds to unplug or unscrew a big item.
Config.Loot.maxPerSearch
4
Most different items one search can turn up.
Config.Loot.replace
{}
Swap item names, for example { plastic = 'plastic_scrap' }.
Config.Disassemble.enabled
true
Skill check, progress bar, then materials. A failed check keeps failKeep (0.5) of the yield.
Config.Logs.webhook
''
glitch-admin webhook channel name. Empty means none.
[!NOTE]
Config.ChainDrops ships with items from the Glitch Studios heist chain (bank_usb, g6_route_intel, weed seeds). Items your inventory does not know are skipped. Replace them with your own items or set Config.ChainDrops = {}.
← Previous Installation Next → Examples