> For the complete documentation index, see [llms.txt](https://mackydev.gitbook.io/mackydev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mackydev.gitbook.io/mackydev/resources/atm-robbery.md).

# 🏧 ATM Robbery

***

Multi-method ATM robbery with witness, framework, and dispatch integration.

> ⚠️ This resource requires our bridge resource ([`mk-bridge`](https://macky-dev.tebex.io/package/7449206)) to function properly.

[Docs](https://mackydev.gitbook.io/mackydev/resources/atm-robbery) • [Discord](https://discord.gg/GBPAGDmegX) • [Showcase](https://youtu.be/bxq4oT_cHfw)

### ⭐ Features

* Multiple robbery methods: Kick / Ignite ATM (fuel or molotov)
* Supports [ESX](https://github.com/esx-framework), [QBCore](https://github.com/qbcore-framework), and [QBox](https://github.com/Qbox-project)
* Dispatch integration ([ps](https://github.com/Project-Sloth/ps-dispatch), [cd](https://codesign.pro/dispatch), [qs](https://www.quasar-store.com/product/dispatch-and-mdt), [tk](https://tkscripts.com/product/dispatch), [rcore](https://store.rcore.cz/package/5789351))
* Falls back to default framework alerts if no supported dispatch is found.
* NPC witness system
* Configurable police requirements
* Configurable cooldowns and rewards
* Fully configurable ATM model support
* Optimized for low resource usage

***

### 📊 Performance

Idle: 0.00ms

Active: \~0.01ms

***

## 📥 Installation

1. Place `mk-bridge` `mk-atmRobbery` inside your server's `resources` folder.
2. Add to your `server.cfg`:

```cfg
ensure mk-bridge
ensure mk-atmRobbery
```

4. Configure `config.lua` to fit your server.
5. Restart your server.

***

### 🔧 Configuration

### 💰 Rewards

Controls how much money players receive per method:

```lua
Config.Rewards = {
    kick = {
        min = 1000,
        max = 2000
    },

    fire = {
        min = 3000,
        max = 6000
    },
}
```

***

### ⏱️ Cooldowns

```lua
Config.Timeout = {
    kick = 120000, -- 2 minutes (in ms)
    fire = 300000, -- 5 minutes (in ms)
}
```

***

### 👮 Police Requirements

```
Config.RequiredPolice = 1
```

***

### 📞 NPC Witness System

```lua
Config.DispatchAlert = true -- Enable/disable all dispatch alerts entirely
Config.NPCCallsCops = true -- If enabled, nearby NPCs have a chance to call the cops
-- If disabled, dispatch alerts will still be sent if DispatchAlert = true
Config.ChanceToCall = 50 -- 50% chance the NPC calls
Config.SearchRadius = 20.0 -- Radius NPC needs to be (in units)
Config.PhoneAnimationTimeout = 10000 -- NPC stays on phone (in ms)
```

***

### 🏧 ATM Models

```lua
Config.Props = {
    'prop_atm_01',
    'prop_atm_02',
    'prop_atm_03',
    'prop_fleeca_atm',
}
```

***

## 🛠️ Support

If you experience any issues, have questions, or would like to report a bug, please open a support ticket through discord.