Laundromat Heist Troubleshooting & FAQ

Common issues

Symptom	Likely cause	Fix
Resource won't start / boot warning printed	A dependency is missing or starts after the heist	Fix `server.cfg` order: see Installation
Items show as a blank box	No inventory image for the item	Add `<item>.png` to your inventory's images folder: see Items
Using the microcamera / RC does nothing	Usable items not registered, or the folder was renamed	Wire the three exports; keep the folder named `vs-laundromat-heist`
NPCs or the gun van don't spawn	Anti-cheat blocking ped/vehicle creation	Whitelist the models in Installation
Heist won't start	Crew size not met, DB down with `RequireDatabase`, or the leader is in debt	Check `crewSize`, the DB connection, and clear any outstanding debt
No heist locations / scouting does nothing	The map isn't running, or `mapResource` doesn't match	Ensure the Go & Wash Laundromat map; set `Config.Heist.mapResource` to its folder name
Minigames error or never open	`vs-minigames` not started	Ensure `vs-minigames` before the heist
Boss dialogue missing	`vs-npc-dialogue` not started	Ensure `vs-npc-dialogue` before the heist
Safe won't open on qb-inventory	It uses a server-authoritative open	It only fires after the crew/phase/distance checks pass: approach as the crew, in the right phase
Police never alerted	Wrong job name in `Config.PoliceAlert.jobs`	Set it to your server's exact police job (or a list)
Debt never clears	Repayment happens in person at the boss	Return to the boss to repay; debt is cash-only

FAQ

Do I need the map? Yes. The heist's locations live in the Go & Wash Laundromat ymaps (Config.Heist.mapResource). The script and map are bundled.

Which frameworks are supported? Qbox, QBCore, ESX, or standalone. It's auto-detected, and forceable via Config.Framework. The framework is used only for money + character identity; it never touches jobs or inventory.

ox_inventory or qb-inventory? Both. ox_inventory is turnkey (full feature set, usable items out of the box). On qb-inventory everything works except two ox-only extras (weapon-durability wear and the ox stash open-hook), which no-op gracefully. See Dependencies.

How many players does it need? Whatever you set in Config.Heist.crewSize: the exact number to start and the prep join cap. 1 for solo testing, 4 for production.

Can I add my own locations? Yes. The script ships with an in-game location creator, and locations are stored in config/locations.lua. If you'd like a hand authoring a new location, reach out on Discord.

Can several heists share reputation? Yes. Set the same Config.Boss.clan on each. Progression is shared per (citizenid, clan).

Is the config escrow-locked? No. config/config.lua is left open for editing via escrow_ignore, so you can tune everything.

Can I pay rewards as dirty money to launder? Yes. Set Config.Contract.payout.type = 'dirty' and point dirtyItem at a launderable item that exists in your inventory.

How to report a bug

Open a ticket on Discord with:

Your framework, target, and inventory (and versions).
Your config/config.lua (or the sections you changed).
The F8 client console output and the server console output around the error.
Exact steps to reproduce, and whether Config.Debug was on.

The more of the above you include, the faster we can pinpoint it.