Laundromat Heist Dependencies & Compatibility
The heist is framework, target, and inventory agnostic: everything is auto-detected. Force any layer in config/config.lua if detection ever misfires.
Compatibility matrix
| Layer | Supported | Config key | Notes |
|---|---|---|---|
| Framework | Qbox · QBCore · ESX · standalone | Config.Framework | Used only for money + character identity. It never touches a framework's jobs or inventory. standalone runs with no economy (test mode). |
| Target | ox_target · qb-target · qtarget | Config.Target | One code path; a bridge translates to whichever is installed. qb-target and qtarget share one API. |
| Inventory | ox_inventory · qb-inventory | Config.Inventory | Item ops + the shared safe stash work on both. |
'auto' detection order: framework Qbox → QBCore → ESX → standalone; target ox_target → qb-target → qtarget; inventory ox_inventory → qb-inventory.
Required resources
Start all of these before vs-laundromat-heist.
| Resource | Required | Purpose |
|---|---|---|
| ox_lib | ✅ | callbacks, notify, locales, shared init |
| oxmysql | ✅ | debt / reputation / prep / audit persistence |
| A target: ox_target or qb-target/qtarget | ✅ | all in-world "eye" interactions |
| An inventory: ox_inventory or qb-inventory | ✅ | items + the safe stash |
vs-npc-dialogue | ✅ (free) | the contact's dialogue box |
vs-minigames | ✅ (free) | the skill-check minigames (vent grate, cable cut, badge scan, code dial) |
| The Go & Wash Laundromat map | ✅ | the heist locations (Config.Heist.mapResource) |
vs-npc-dialogue and vs-minigames are free companion resources from the same author. The heist calls into them for the dialogue avatar (WarmPedAvatar / ReleasePedAvatar) and the minigames (StartCableCut, StartBadgeScan, StartCodeDial).
ox_inventory vs qb-inventory
ox_inventory is the turnkey option with the full feature set. On qb-inventory the item economy and the safe stash work, with two ox-only extras that degrade gracefully (they simply no-op, so nothing breaks):
| Feature | ox_inventory | qb-inventory |
|---|---|---|
| Item economy (all heist items) | ✅ | ✅ |
| Crew-only safe stash | ✅ (inventory open-hook) | ✅ (server-authoritative open after crew/phase/distance checks) |
| Usable items (RC Bandito, remote, microcamera) | ✅ via item export | Register them as usable with qb's own mechanism (or run ox_inventory) |
| Weapon-durability wear (washer "breach force" cost) | ✅ | no-op |
On qb-inventory the safe stays crew-only via a server-authoritative open that only fires after the crew, phase, and distance checks pass, so gating is preserved even without the ox open-hook.
See Items for the exact registration snippets for both inventories.
Startup order
ensure ox_lib
ensure oxmysql
ensure ox_target # or qb-target / qtarget
ensure ox_inventory # or qb-inventory
ensure vs-npc-dialogue
ensure vs-minigames
ensure wxmaps_laundromat # the map
ensure vs-laundromat-heist
Full walkthrough on the Installation page.