Requirements#
The server
| Framework | qbx_core (Qbox). ESX and plain QBCore are not supported. |
| Resources | ox_lib, ox_target, ox_inventory |
| Server setup | OneSync enabled. Do not run sv_entityLockdown strict (see Troubleshooting). |
| Database | None. The resource creates no tables. |
| Tested with | qbx_core 1.24.0, ox_inventory 2.48.0, ox_lib 3.40.0, ox_target 1.17.2 |
Optional
Each of these is detected at run time. Its feature is skipped when the resource is not running.
| glitch-criminaltablet | Truck contracts on the tablet, the pickup laptop, REP and the shared crew lineup. Without it, the insider ped and g6_route_intel start the job and the payout comes from Config.Standalone. |
| sd-phone | The payphone call. It needs a build that exports RegisterPayphoneLine, RemovePayphoneLine, getPhoneNumber, sendSystemMessage and sendLocation. Without those the truck spawns on drive-up. |
| glitch-xpSystem | XP and the heist perks: faster planting and looting, a bigger take, a chance to keep a charge. |
| glitch-uiElements | The on-screen task list. Without it the player only gets notifications. |
| glitch-minigames | The minigame on the pickup laptop. |
| glitch-crafting | Crafting components rolled from the bags. |
| glitch-admin | Crime log entries. |
| glitch-abstraction | Linked at run time as a fallback for framework and inventory calls. Qbox with ox_inventory does not need it. |
| glitch-economy | Crime entries for each run, when it is running. |
| rc-interactions | A dialogue for the insider. Without it the insider has a plain target option. |
| ps-dispatch | The police alert. Other dispatch scripts can be wired in Kit.Alert in kit/server.lua. |
Installation steps#
1Folder
Copy the glitch-truckRobbery folder into your resources folder. The folder name is case-sensitive:
/resources/glitch-truckRobbery/
2Items
Open install/ox_inventory_items.lua and copy the entries into ox_inventory/data/items.lua, inside the returned table. Skip any item you already have; black_money and goldbar usually exist. The items are:
| Item | Use |
|---|---|
c4_charge |
Planted on the back doors. |
g6_route_intel |
Starts a run when no tablet job is used. |
money_bag |
The sealed bag taken from the truck. |
goldbar, silver_bar, gold_coin, g6_dispatch_drive |
Extra loot rolled per bag. |
humane_keycard, bobcat_keycard |
The keycard a guard may carry. |
black_money |
Dirty money paid out when a bag is opened. |
Add PNG pictures for them to ox_inventory/web/images if you want icons. Restart the server so the items load.
3server.cfg
Start the resource after its requirements, and after glitch-criminaltablet if you use it:
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target
ensure glitch-uiElements
ensure glitch-criminaltablet
ensure glitch-truckRobbery
Leave out any optional line for a resource you do not run.
4Permissions
The /truckreset command is registered with restricted = 'group.admin', so ox_lib already grants it to that group. To grant it to another group, add its ACE:
add_ace group.admin command.truckreset allow
5First start
A few seconds after start the console lists anything that is missing: items, XP, the tablet job or the sd-phone exports. Fix what it lists.
6Standalone start
Without glitch-criminaltablet, walk to the insider (Config.Insider.coords) and pay for the route, or hand him a g6_route_intel item. You can also use the item from your inventory. With the tablet running the insider is off and the truck contract does the same job.
Updating#
The package is escrowed. config.lua, kit/, install/, README.md, LICENSE and CHANGELOG.md stay open for editing. kit/client.lua and kit/server.lua are shared kit files that ship in the other Glitch Studios criminal resources, so avoid editing them.
Back up config.lua, then merge the new defaults into your copy rather than replacing it. Check CHANGELOG.md for new items or keys. Restart glitch-truckRobbery after its dependencies. Avoid updating during a run: the truck and guards are removed when the resource stops.