Usage
Overview
ATMs across the map can be robbed using one of three methods. Each method is independent - only one method can be active on a given ATM at a time. All interactions are target-based (approach the ATM and use the interaction menu).
Method 1 - Rope Pull
Required item: metal_rope
- Approach an ATM and target it → Tie Rope. Your character grabs the rope with a holding animation.
- Walk to the rear of any eligible vehicle (within 1.7 m of the trunk) and target the vehicle → Tie Rope to attach the other end.
- Get in the driver's seat and accelerate hard. The ATM is pulled progressively off the wall as the vehicle builds momentum. Concrete debris particles play as the ATM tears free.
- Once the ATM is fully ripped off (pull threshold reached) it becomes a physics prop dragged behind the vehicle.
- Wait for the unlock timer to count down (default 4–6 minutes). A sound plays when it unlocks. The ATM blip updates for officers every 30 seconds.
- Target the pulled ATM → Search to loot it with a progress bar.
TIP
The rope can be detached from the vehicle at any time via the trunk interaction. Officers on-duty can Secure ATM to stop it being searched.
Ineligible vehicles
Motorcycles, bicycles, boats, helicopters, planes, trains, ATVs (Blazer variants), forklifts, trailers and several other utility vehicles cannot be used to pull an ATM. Use a standard car or truck.
Method 2 - Explosive
Required item: atm_bomb
- Approach an ATM and target it → Rig Explosive. A 3-second progress bar plays as the bomb is attached to the ATM.
- Stand clear. The bomb beeps and detonates after a configurable delay (default 5 minutes).
- After the explosion the ATM is replaced by the destroyed
prop_fleeca_atm_boommodel. - Target the wreckage → Search to loot it with a progress bar.
Durability
The atm_bomb loses 10% durability each time the rigging progress bar is cancelled. If the item reaches 0% durability it will explode immediately, killing the player. Keep track of your bomb's condition.
Method 3 - Hack
Required item: atm_hack_device
- Approach an ATM and target it → Plug in Device. A 6.5-second progress bar plays as the device is physically attached to the ATM.
- Target the ATM again → Initiate Hack to start the minigame.
- Pass the minigame. On failure the ATM enters a fail cooldown (default 40 seconds) and the device loses 20% durability. After 3 total failures the ATM locks down completely.
- On success the ATM is marked as hacked. Wait for the search delay (default 5 minutes) before the cash can be retrieved.
- Target the ATM → Search to loot it.
TIP
The device is destroyed on successful search by default (breakItemOnSuccess = true). If you don't need the item back, go straight to searching once the delay expires.
The device can be unplugged at any time before hacking starts via the Unplug Device interaction, recovering the item.
Cooldowns
| Cooldown | Default | Description |
|---|---|---|
| Global | 5 min | After any ATM robbery completes, no ATM on the server can be robbed until this expires |
| Owner | 60 min | Applied to the group leader after a robbery |
| Affiliate | 50% of owner (30 min) | Applied to all other group members |
| ATM reset | 45 min | How long before a robbed ATM respawns and is robbable again |
| Hack fail | 40 sec | Cooldown between hack attempts after a failed minigame |
Police
| Interaction | Condition |
|---|---|
| Dispatch alert (10-90) | Sent at 100% chance when any robbery method is initiated |
| ATM tracker blip | Appears for on-duty officers when an ATM is breached; updates position every 30 seconds |
| Secure ATM | Officers can target a pulled ATM via a vehicle interaction to lock it down and prevent searching |
Loot
Each method rolls against its own loot table 2 times per search.
| Method | Common | Rare | Epic | Legendary |
|---|---|---|---|---|
| Rope | 20–40 money rolls | 30–45 money rolls | 50–65 money rolls | 75–95 money rolls |
| Explosive | 15–24 money rolls | 25–40 money rolls | 45–65 money rolls | 80–120 money rolls + drive items |
| Hack | 20–35 money rolls | 30–45 money rolls | 50–65 money rolls | 75–95 money rolls |
Configuration
Shared (config/sh_config.lua)
| Option | Default | Description |
|---|---|---|
SHConfig.Debug | false | Enables debug overlays and extra target options on ATMs |
SHConfig.PoliceJobs | { "police", "bcso" } | Job names that count toward the police requirement and can use Secure ATM |
SHConfig.ATMModels | 3 models | ATM prop models the script applies interactions to |
SHConfig.HackDeviceItem | atm_hack_device | Item name for the hacking device |
SHConfig.ExplosiveItem | atm_bomb | Item name for the explosive |
SHConfig.RopeItem | metal_rope | Item name for the rope |
Server (config/sv_config.lua)
| Option | Default | Description |
|---|---|---|
Config.GlobalCooldown | 5 | Minutes before any ATM can be robbed again after a robbery |
Config.OwnerRobCooldown | 60 | Minutes before the group owner can rob another ATM |
Config.AffiliateRobCooldown | 50 | Percentage of owner cooldown given to affiliates |
Config.LogWebhookurl | "" | Discord webhook URL for robbery logs |
Config.Rope.minGroupSize | 1 | Minimum group members for rope method |
Config.Rope.requiredCops | 0 | Officers required online for rope method |
Config.Rope.unlockTime | 240–360 s | Seconds before a pulled ATM can be searched |
Config.Rope.resetTime | 45 | Minutes before ATM resets after rope robbery |
Config.Rope.tracker.enabled | true | Enable police tracker blip for rope robberies |
Config.Explosive.minGroupSize | 1 | Minimum group members for explosive method |
Config.Explosive.requiredCops | 0 | Officers required online for explosive method |
Config.Explosive.durabilityLossOnFail | 10 | % durability lost from atm_bomb on failed rig |
Config.Explosive.explodeDelayTime | 5–5 min | Minutes until the bomb detonates |
Config.Explosive.resetTime | 45 | Minutes before ATM resets after explosive robbery |
Config.Hack.minGroupSize | 1 | Minimum group members for hack method |
Config.Hack.requiredCops | 0 | Officers required online for hack method |
Config.Hack.durabilityLossOnFail | 20 | % durability lost from atm_hack_device per failed hack |
Config.Hack.failsAllowed | 3 | Minigame failures before ATM locks |
Config.Hack.failCooldown | 40 | Seconds to wait after a failed hack attempt |
Config.Hack.breakItemOnSuccess | true | Destroy the hack device after a successful search |
Config.Hack.searchDelay | 5–5 min | Minutes to wait after a successful hack before searching |
Config.Hack.resetTime | 45 | Minutes before ATM resets after hack robbery |
Client (config/cl_config.lua)
| Option | Default | Description |
|---|---|---|
Config.NoAttachClass | 8 classes | Vehicle classes that cannot be used to pull an ATM |
Config.NoAttachModels | ~30 models | Specific vehicle models blacklisted from pulling |
Config.PullAmountMultiplier | 1.7 | Multiplier applied to speed-based pull force; higher = easier to pull |