Studios
ATM Robberyhouse-3.jpg

Configuration

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

Configuration files#

Everything is in config.lua. All player text is in locales/en.lua. The items are defined in install/items.lua.

Gate and tool#

Setting Default What it does
Config.Gate.minPolice 2 On-duty police needed before the skimmer can go on.
Config.Gate.minRep 0 Tablet REP needed. Skipped without the tablet.
Config.Gate.requires {} Prior tablet jobs needed, for example { jobId = 'store_rob', minCompletions = 5, label = 'Convenience Store' }. Skipped without the tablet.
Config.PoliceJobs police, sheriff, bcso, sasp Fallback list when a job has no type leo.
Config.Item atm_hacker The skimmer item.
Config.ItemUses 3 Uses per skimmer. Without ox_inventory every attach spends one use.
Config.AtmModels prop_atm_01, prop_atm_02, prop_atm_03, prop_fleeca_atm World ATM props that can be robbed.
Config.TargetRadius 0.75 Radius in metres of the target zone on each wall ATM. Keep it under half the gap between ATMs that stand side by side.

Hacking and skimming#

Setting Default What it does
Config.Minigame.provider auto auto uses glitch-minigames when it runs. ox_lib always uses skill checks.
Config.Minigame.oxHack easy, easy, medium ox_lib skill check difficulties for the hack.
Config.Minigame.oxDrill easy, medium, medium, hard ox_lib skill check difficulties for the drilling.
Config.Hack.export StartTracerouteGame glitch-minigames export used for the hack.
Config.Hack.difficulty { preset = 'normal', traces = 2 } Settings passed to the minigame.
Config.Hack.minSolveMs 3000 Fastest believable solve. The server rejects results that arrive sooner than the attach bar plus this value.
Config.Hack.attachTime 4000 Milliseconds spent fitting the skimmer.
Config.Skim.duration 60 Seconds the skimmer works.
Config.Skim.alertAfter nil nil sends the police alert when the skim ends. A number sends it that many seconds in.
Config.Skim.alertChance 1.0 Chance of a police alert at the skim.
Config.Skim.maxDistance 15.0 Metres the player may walk away before the skim cancels.
Config.Skim.hackTimeout 120 Seconds a started hack may take before it is dropped.

Rope, pull and escape#

Setting Default What it does
Config.Rope.item rope Item taken when tying and given back on removal. nil means no item.
Config.Rope.length 8.0 Rope length in metres. The car must be parked within it, and driving further rips the ATM out.
Config.Rope.tieTime, hookTime, removeTime 4000, 2500, 120000 Milliseconds for tying, hooking and taking the rope off.
Config.Rope.tieWindow, hookWindow, pullWindow 300 each Seconds allowed for each stage before it expires.
Config.Pull.gap 7.0 Metres of rope between the car's rear and the dragged ATM.
Config.Pull.friction 6.0 How fast a sliding ATM slows down. Higher is heavier.
Config.Pull.maxSlide false Cap on the ATM's own slide speed in m/s. false uses the built-in 60 m/s limit.
Config.Pull.tugs { 12, 20 } Range for the random number of hard pulls needed per ATM. The number is never shown.
Config.Pull.tugMinSpeed 3.0 Speed in m/s away from the ATM that counts as a tug.
Config.Pull.slack 2.0 Metres the car must come back toward the ATM before the next tug counts.
Config.Pull.carDrag 0.0 How much a tight rope slows the car. 0.0 means no slowdown.
Config.Pull.alertChance 1.0 Police alert chance at the rip-out. Perks do not reduce it.
Config.Pull.maxMinutes 30 Minutes after the rip-out to finish before the job is given up.
Config.Escape.minDistance 0.0 Metres the ATM must be from the rip-out point. 0.0 means no get-away distance.
Config.Escape.policeRadius 150.0 No on-duty police within this radius of the ATM when the rope comes off.
Config.Escape.maxCarSpeed 2.0 Speed in m/s below which the car counts as stopped.

Config.Pull has more keys for the drag feel (maxAngle, turnRate, wobble, layPitch, yawOffset, tugBounce, jolt). They are commented in the file.

Take apart and cooldowns#

Setting Default What it does
Config.TakeApart.export StartDrilling glitch-minigames export used for drilling.
Config.TakeApart.anim jackhammer jackhammer or drill.
Config.TakeApart.item drill Required in the inventory and not consumed. nil means no item.
Config.TakeApart.locks 2 Locks to drill open, one after the other.
Config.TakeApart.maxAttempts 3 Failed drills before the dye pack ruins the cash.
Config.TakeApart.minSolveMs 3000 Fastest believable drill solve per lock.
Config.TakeApart.throwTime 2500 Milliseconds spent dumping the ATM.
Config.AtmCooldown 3600 Seconds an ATM rests after it was skimmed.
Config.AtmRespawn 900 Seconds after the rip-out before a new ATM is back in the wall, once the robbery is over.
Config.FailLock 3600 Seconds an ATM locks after a failed hack.
Config.PlayerCooldown 900 Seconds between skims for one player. With the tablet, its atm_rob cooldown is used instead.

Crew and payout#

Setting Default What it does
Config.Crew.max 2 People in the crew, robber included.
Config.Crew.radius 15.0 Metres from the robber to count as crew at payout.
Config.Standalone.pot { 3667, 4667 } Minimum and maximum pot without the tablet. The pot is split between the crew.
Config.Standalone.account dirty dirty, cash or bank.
Config.DirtyMoney.item black_money Dirty money item for ox_inventory.
Config.DirtyMoney.qbItem markedbills Dirty money item for QBCore without ox_inventory.

A dirty money payout that does not fit in the inventory drops at the player's feet. If that also fails it falls back to cash.

Drops#

Config.ChainDrop gives a bonus item some other heist script can require. Defaults: enabled = true, item = 'alarm_codes', chance = 0.08. Set guaranteeAt (for example 6) to count misses per character and guarantee the drop on that run.

Config.MaterialDrop gives the player who opens the ATM one item picked by weight. Full pockets drop it on the ground.

Item Weight Amount
metalscrap 30 4 to 8
plastic 25 3 to 6
iron 20 2 to 4
copper_wire 17 2 to 4
electronickit 8 1

Integrations#

Setting Default What it does
Config.Tablet.enabled true Use glitch-criminaltablet while it runs. Otherwise Config.Standalone pays.
Config.Tablet.resource glitch-criminaltablet Resource name to look for.
Config.Tablet.jobId atm_rob Job id in the tablet.
Config.Tablet.completeEvent glitch_criminaltablet:reportJobComplete Server event the tablet listens on to book a finished job.
Config.Hooks.crimeLedger true Log payouts to glitch-economy through its LogCrime export.
Config.Hooks.mapLegend true Name the alert blip in the glitch-pauseMenu map legend.
Config.Dispatch auto auto picks the first started of ps-dispatch, cd_dispatch, qs-dispatch and rcore_dispatch. builtin sends a notification and blip to on-duty police. none turns alerts off.
Config.TaskTag The Fixer Tag on the glitch-uiElements task list.
Config.Prop prop_phone_ing, height 1.05 The skimmer prop shown on the ATM. Raise or lower height if it misses the slot.
Config.Debug false Target zone debug, console prints and the /atmscan command.

XP and perks#

Config.XP has enabled = true, category = 'heisting' and perRun = 80, paid to every participant. Caps: maxTakeBonus 0.15, maxAlertCut 0.40, maxSpeedCut 0.24, maxSkimCut 0.40, maxChainBonus 0.10 and maxCooldownCut 0.20. Set enabled = false to turn XP and perks off.

Perk Key Effect
Steady nerves heist_speed Shorter attach, tie and rope removal bars.
Bag man heist_take Bigger pot, capped at 15%.
Cool customer heist_alert Lower skim alert chance.
Ghost protocol hacking_alert Lower skim alert chance. Both alert perks together are capped at 40%.
Overclock hacking_atm_speed Faster skim.
Inside man heist_chain_drop Higher alarm_codes chance.
Planner heist_cooldown Shorter player cooldown.