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#
Put the
glitch-humaneHeistfolder in your resources folder. The folder name is case-sensitive.Add the items from
install/items.luatoox_inventory/data/items.lua, inside the returned table. Add images namedhazmat_suit.png,methylamine_lab.pngandhumane_keycard.pngtoox_inventory/web/images, or remove theclientimage lines.black_moneyis the standard ox_inventory item and is not repeated.Create the six ox_doorlock doors listed under Doors below.
The table
glitch_humane_owedis created when the resource starts. If your database user cannot create tables, runsql/install.sqlonce by hand.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-humaneHeistEdit
config.lua: at least the Chemist's position and phone number. If you move the lab, changeConfig.Alarm.centerand thecenterpoint inheist/humane.luatogether.
[!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 1HumaneLabs Garage Door 2HumaneLabs Cold RoomHumaneLabs Decontamination 1HumaneLabs Labs 1HumaneLabs 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.