Requirements#
The server
| Framework | qbx_core (Qbox), qb-core or es_extended. |
| Resources | ox_lib and ox_target are required. ox_inventory is strongly recommended, because skimmer uses are stored in item metadata. |
| Server setting | OneSync enabled. |
| Database | None. No SQL is needed. |
| Optional | glitch-minigames (Traceroute hack and Fleeca drilling; without it the resource uses ox_lib skill checks), glitch-criminaltablet (REP gate, payout, REP, heat and cooldown from its atm_rob job), glitch-xpSystem (heisting XP and perks), glitch-uiElements (task list while a robbery runs), glitch-economy (logs what the script paid out), glitch-abstraction (notifications, progress bars and framework calls), glitch-pauseMenu (names the alert blip in its map legend), and one of ps-dispatch, cd_dispatch, qs-dispatch or rcore_dispatch for police alerts |
Optional resources are detected at run time. The matching feature is skipped when one is not running.
The package was tested with qbx_core 1.24.0, ox_inventory 2.48.0, ox_lib 3.40.0 and ox_target 1.17.2.
Installation steps#
1Place the folder
Copy the glitch-atmRobbery folder into your resources directory. The folder name is case-sensitive and must stay glitch-atmRobbery.
/resources/glitch-atmRobbery/
2Add the items
Paste the entries from install/items.lua into ox_inventory/data/items.lua, and copy install/images/atm_hacker.png into ox_inventory/web/images. QBCore and ESX servers without ox_inventory add the same three items (atm_hacker, rope, alarm_codes) to their own item list.
Then check that the standard items exist: drill, black_money, metalscrap, plastic, iron, copper_wire and electronickit. If your server names them differently, change the names in config.lua (Config.TakeApart.item, Config.DirtyMoney and Config.MaterialDrop).
3Server configuration
Start the resource after its dependencies:
ensure ox_lib
ensure ox_target
ensure ox_inventory
ensure qbx_core
ensure glitch-abstraction
ensure glitch-minigames
ensure glitch-uiElements
ensure glitch-atmRobbery
Drop the glitch-* lines you do not run. Only the ox resources and your framework are required.
4Give players the tools
The resource does not sell anything. Make atm_hacker, rope and drill available through a shop, crafting or your criminal vendor.
5Permissions
/atmreset is restricted to group.admin. Make sure your admins have that ACE group. Nothing else needs permissions.
6Start and check
Start the server. The console prints one line when the checks pass, or lists what is missing, such as an item that does not exist.
Updating#
Back up config.lua and locales/en.lua, replace the folder, then merge your changes into the new files. Check CHANGELOG.md for new keys. Cooldowns and locks are stored in resource KVP, so they carry over an update. Restart the resource after its dependencies.