Studios
Store Robberyhouse-3.jpg

Installation

SoonStore RobberyQbox
PAGE 02 OF 06  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs

Requirements#

The server

Framework qbx_core (Qbox). ESX and plain QBCore are not supported.
Resources ox_lib, ox_target, ox_inventory, glitch-heistEditor (the heist engine) and glitch-minigames (the drill and lockpick games).
Server setting OneSync enabled.
Database None. No SQL is needed.
Optional glitch-criminaltablet (contracts and an admin testing bypass), glitch-economy (crime ledger entries for lottery items and prizes), glitch-admin (a staff log entry when a client sends something it should not), glitch-xpSystem and ps-dispatch (used by the engine for XP and 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#

  1. Copy the glitch-storeRobbery folder into your resources folder. The folder name is case-sensitive and must stay glitch-storeRobbery.

  2. Add the items from install/ox_inventory_items.lua to ox_inventory/data/items.lua, inside the returned table. Skip any you already have; lockpick, advancedlockpick, drill and black_money exist in most Qbox setups. Item images are optional.

  3. There is no SQL to run.

  4. Add ensure glitch-storeRobbery to server.cfg, after the engine, the minigames, ox_inventory, ox_target and qbx_core:

    ensure ox_lib
    ensure qbx_core
    ensure ox_target
    ensure ox_inventory
    ensure glitch-minigames
    ensure glitch-heistEditor
    ensure glitch-storeRobbery
    add_ace group.admin command.storedrill allow
    add_ace group.admin command.storereset allow
    
  5. Start the server. After five seconds the console prints ready: N stores on the heist engine, or lists what is missing (the engine, the minigames or an item).

  6. Contracts are off by default (Config.Heist.requireContract = 'no'). Set it to 'yes' if you run glitch-criminaltablet.

  7. The overrides/ folder loads after config.lua and holds an example set of server values: Australian store names, extra police jobs, the testing bypass switched on and contracts required. Delete the file or edit it to your own values before you go live.

[!NOTE] Both commands are restricted to group.admin. Give that group to your staff, or change the restriction in server/extras.lua.

Updating#

Replace everything except config.lua, overrides/ and data/drillspots.json, then restart glitch-heistEditor and after it this resource. The definitions are handed to the engine again whenever either one starts. Saved drill spots are kept in the resource key-value store, so a package update does not overwrite them.

Once a definition has been edited in /heisteditor, the editor copy wins over the seed values in config.lua.