Studios
Humane Heisthouse-3.jpg

Installation

SoonHumane HeistQbox
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, oxmysql, ox_target, ox_inventory
Heist engine glitch-heistEditor runs the raid and this resource registers its definition with it. It is a separate Glitch Studios product from the same store.
Minigames A pack that exports StartNumberedSequenceGame, StartWireConnectGame, StartKeysGame, StartBackdoorSequence, StartComboInputGame, StartVarHack, StartBruteForce and StartDataCrack. glitch-minigames provides them. For another pack, change the export names in heist/humane.lua.
Doors and map ox_doorlock and a Humane Labs map (an MLO with the facility interior). Neither is part of this package.
Dispatch A dispatch resource for the police call, as set up in glitch-heistEditor.
Items humane_keycard and hacking_laptop, both in install/items.lua. With glitch-criminaltablet the keycard comes with the contract. Without it, hand the keycard out yourself, for example from a shop or loot table.
Database MariaDB or MySQL 8 through oxmysql.
Optional glitch-criminaltablet (contract, the Chemist's ped, trust and the REP report), sd-phone (the Chemist texts the host and is added as a contact), glitch-crafting (suit plans and crafting drops), glitch-xpSystem (a bigger pot for the host), glitch-economy (crime ledger entries), glitch-methCar (reads the research bonus)

Tested with qbx_core 1.24.0, ox_inventory 2.48.0, ox_lib 3.40.0, ox_target 1.17.2 and oxmysql 2.14.2. The optional resources are detected at run time, and the matching feature is skipped when one is not running.

Installation steps#

  1. Put the glitch-humaneHeist folder in your resources folder. The folder name is case-sensitive.

  2. Add the items from install/items.lua to ox_inventory/data/items.lua, inside the returned table. Add images named hazmat_suit.png, methylamine_lab.png and humane_keycard.png to ox_inventory/web/images, or remove the client image lines. black_money is the standard ox_inventory item and is not repeated.

  3. Create the six ox_doorlock doors listed under Doors below.

  4. The table glitch_humane_owed is created when the resource starts. If your database user cannot create tables, run sql/install.sql once by hand.

  5. Add to server.cfg, after glitch-heistEditor, ox_lib, oxmysql, qbx_core, ox_inventory and ox_target:

    ensure glitch-heistEditor
    ensure glitch-minigames
    ensure glitch-humaneHeist
    
  6. Edit config.lua: at least the Chemist's position and phone number. If you move the lab, change Config.Alarm.center and the center point in heist/humane.lua together.

[!NOTE] Restarting glitch-heistEditor stops this resource. Ensure it again afterwards.

Doors#

The definition locks and unlocks these ox_doorlock doors by name. Create them with /doorlock on your map and use exactly these names:

  • HumaneLabs Garage Door 1
  • HumaneLabs Garage Door 2
  • HumaneLabs Cold Room
  • HumaneLabs Decontamination 1
  • HumaneLabs Labs 1
  • HumaneLabs Elevator 1

The coordinates in the definition are for the stock Humane Labs location. If your map sits elsewhere, move the points in heist/humane.lua or edit the raid live with /heisteditor.

Permissions#

This resource adds no commands and needs no ACE entries. Raid editing uses the permissions of glitch-heistEditor.

Updating#

Back up config.lua and heist/humane.lua, replace the rest, then merge new settings into your copies. The ticket column is added to glitch_humane_owed on start if an older table lacks it. Payouts the Chemist is holding survive a restart.