Studios
ATM Robberyhouse-3.jpg

Installation

SoonATM RobberyQBCore · Qbox · ESX
PAGE 02 OF 06  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs

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.