Studios
House Robberyhouse-1.jpg

Configuration

House RobberyQBCore · Qbox · ESX
PAGE 03 OF 06  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

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.

Freelance, contact NPC and phone#

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 = {}.