Installation

Installation Guide – v42-ATMRobbery

Step 1: Ensure All Dependencies Are Installed

Before proceeding, confirm that all required dependencies for your framework (QBCore or ESX) are:

• Installed

• Running properly

• Using the latest stable versions

Note: This script supports both ps-dispatch and qs-dispatch. Make sure your chosen dispatch system is installed and configured correctly.

---

Step 2: Install the Resource

1. Drag and drop the v42-atmrob folder into your server’s resources directory.

2. Add the following line to your server.cfg after all dependencies:

ensure v42-atmrob

---

Step 3: Add Items & Images

Make sure the following required items are added to your inventory system:

['atm-bomb'] = {
  ['name'] = 'atm-bomb',
  ['label'] = 'Explosive',
  ['weight'] = 2500,
  ['type'] = 'item',
  ['image'] = 'atm-bomb.png',
  ['unique'] = false,
  ['useable'] = false,
  ['shouldClose'] = true,
  ['combinable'] = nil,
  ['description'] = 'Used to blow up things?'
}

Also ensure that any related images (e.g., atm-bomb.png) are placed in your inventory UI image folder.

---

Step 4: Import SQL Files

No SQL file is required for this script.

---

Step 5: Configure the Script

Open config.lua and set up the core settings:

• Config.Framework – 'qb' or 'esx'

• Config.CoreName – Your framework’s folder (e.g., 'qb-core')

• Config.Debug – Enable or disable debug messages

• Config.policeDispatch – 'ps-dispatch' or 'qs-dispatch'

Police settings:

• Config.PoliceJob – Set your server's police job name

• Config.ATMCops – Minimum number of cops required

---

Step 6: Configure Robbery & Rewards

Still in config.lua, review these settings:

• Config.BombItem – Required item to trigger a robbery (e.g., 'atm-bomb')

• Config.SuccesChance – Success rate (1 = 25%, 4 = 100%)

• Config.Cooldown – Cooldown time per ATM in minutes

Reward options:

• Config.RewardItem – Set true for item reward, false for cash

• Config.LootItem – Name of the reward item (e.g., markedbills)

• Config.RewardAmount – Max item reward amount

• Config.Worth – If using marked bills (min/max worth)

• Config.Money – If using cash (min/max reward)

---

Step 7: Start or Restart the Server

To apply all changes:

• Run the following in your server console or F8:

  refresh
  ensure v42-atmrob

• Or restart your server

---

Optional Commands & Interactions

• Plant Bomb – Requires atm-bomb; interact at an ATM

• Loot ATM – If successful, loot items or cash

• Police Confiscation – Police can confiscate robbed ATMs

• Alerts – Police receive dispatch alerts during robbery attempts

---

Notes

• Supported ATM models: 'prop_atm_01', 'prop_atm_02', 'prop_atm_03', 'prop_fleeca_atm'

• Language strings and UI texts can be customized via Config.Lang

• Make sure no other ATM robbery scripts are running alongside this one

• Test on a local/staging server before full deployment