CS_ATMROBBERY

An ATM robbery system with support for ESX, configurable police requirements, cooldowns, rewards, and webhook logging.


Installation

start CS_ATMROBBERY

Configuration

Config.lua

This configuration file defines how ATM robberies work.

General Settings
  • Locale: Supported → "EN" or "DE"

  • AtmModels: List of model hashes that count as ATMs

  • NeedItem: Item required to rob (or nil for none). Example: "bread"

  • OfficersToRob: Minimum officers needed on duty. Example: 2

  • AlertedJobs: Jobs that get notified. Example: { "police", "swat" }

  • MaxRobsAtSameTime: Max simultaneous robberies. Example: 2

  • RobCooldown: Cooldown per ATM (seconds). Example: 60

  • AutomaticRobEnd: Time until robbery aborts automatically (seconds). Example: 300

Controls
  • PlaceBombKey: Default 49 (INPUT_CONTEXT → F)

  • LootMoneyKey: Default 49 (INPUT_CONTEXT → F)

  • StopLootingKey: Default 46 (INPUT_FRONTEND_CANCEL → E)

Robbery Variants
  • Variant: "Bomb" or "Welding"

  • WeldingTime: Time in seconds for welding. Example: 5

  • ShowExplosion: true/false (for Bomb variant)

Sounds & Effects (if ShowExplosion = false)
  • SoundName: "Drill_Pin_Break"

  • SoundDict: "DLC_HEIST_FLEECA_SOUNDSET"

  • ParticleName: "ent_brk_sparking_wires"

  • ParticleDict: "core"

Rewards
  • MinimumMoney: Minimum cash reward. Example: 10

  • MaximumMoney: Maximum cash reward. Example: 50

  • lootTime: Time for looting in seconds. Example: 60

  • CashPiles: Loot prop models. Example: "bkr_prop_bkr_cashpile_02"

Animations
  • animDict: "anim@heists@ornate_bank@grab_cash_heels"

  • animName: "grab"


Notifications & Locales

Notification System
  • Notification(title, msg, type) → HUD notifications (via cs_hud or another HUD system)

  • HelpNotification(msg, key) → Displays help text

Locale Support
  • English (EN)

  • German (DE)

  • Configurable messages for robbery state, police alerts, and rewards


Webhooks
WebhookAtm = {
  Colors = { ["Started"] = 43775, ["Finished"] = 43775 },
  RobberyStarted = "",
  RobberyFinished = "",
}
  • RobberyStarted → Logs when a player starts robbing an ATM

  • RobberyFinished → Logs when a player finishes robbing an ATM (with amount stolen)

Tip: Leave the URL as an empty string "" if you do not want the webhook to trigger for that event.

Features
  • Rob ATMs across the map

  • Requires optional item (NeedItem)

  • Police jobs alerted instantly

  • Configurable minimum officers requirement

  • Simultaneous robbery limit

  • Automatic robbery abort after set time

  • Bomb or Welding robbery style

  • Looting system with animations & cash props

  • Discord webhook integration for start & finish events

  • English & German locale support


Support

If you have any further questions, open a ticket on our discord server: discord.gg/core-services

Last updated

Was this helpful?