General Questions
What frameworks are supported?
What frameworks are supported?
The script supports QBCore, Qbox, and ESX through the Project X Bridge. Set
Framework to 'auto' in the bridge config and it will detect your framework automatically.Custom frameworks work as well if you add the framework exports in the bridge’s open source files. Set Framework to 'custom' and implement the adapter functions in projectx-bridge. See the Bridge Overview.Do I need the Project X Bridge?
Do I need the Project X Bridge?
Yes. The bridge is required for this script to function. It handles framework detection, inventory, dispatch, notifications, progressbars, XP, evidence, logs, and global cooldowns. See the Bridge Installation page for setup instructions.When you purchase K4MB1 Maze Bank Robbery, the
projectx-bridge asset is automatically delivered to your CFX portal.Do I need a custom map?
Do I need a custom map?
Yes. This variant requires the matching K4MB1 Maze Bank interior map from K4MB1 Maps. Step and trolley coordinates in
config/config.lua are authored for that interior — do not use default Maze Bank or other variant coords without retuning.What dispatch systems are supported?
What dispatch systems are supported?
The bridge supports 30+ dispatch systems including PS Dispatch, CodeSign, CodeSign 3D, LB Tablet, FD Dispatch, Wasabi MDT, Oxide Dispatch, VX MDT, Sonoran CAD, and many more. Set
Dispatch to 'auto' in the bridge config for automatic detection. See the FAQs for the full list with config values and links.What is the difference between loud and silent approaches?
What is the difference between loud and silent approaches?
The silent approach is higher risk but offers a higher potential reward. Failing minigames during silent accumulates strikes; reaching the limit removes trolleys based on
StrikeAmount (default 3) from the up-to TotalTrollys (default 6) pool. The loud approach is lower risk with a fixed trolley count controlled by StrikeLoud (default 4), and may trigger dispatch immediately via DispatchLocation["Loud"].Can I run the robbery solo?
Can I run the robbery solo?
Yes. Set
Disable2PlayerPuzzles to true in config/config.lua to disable all two-player puzzles. You can then complete the entire robbery alone.How do I change which minigames are used?
How do I change which minigames are used?
Open
opensource/client/client.lua and find the projectx-mazebankrobbery-k4mb1:client:Minigames callback. Each robbery step has its own elseif block where you can swap the minigame export for any resource you prefer. You can also return true inside any block to skip that minigame entirely.See the Open Source page for the default step-to-minigame table.Configuration Questions
How do I require a minimum number of police?
How do I require a minimum number of police?
Set
MinimumPolice to the number you want in config/config.lua, and make sure the correct jobs are listed in PoliceJobs.How do I gate the heist behind an XP or level requirement?
How do I gate the heist behind an XP or level requirement?
Set
SkillSystem to true and configure MinimumLevel in config/config.lua. You also need a compatible XP system integrated in the bridge config (XPSystem).Supported systems include projectx-xp, pickle_xp, sd-levels, cw-rep, and OT_skills. See the FAQs for bridge XP config values.How do I set up bonus items at the end of the heist?
How do I set up bonus items at the end of the heist?
Enable
Bonus.Status and configure the Bonus.Items table in config/config.lua. Each item has a Chance percentage and an Amount range.Troubleshooting
The script won't start
The script won't start
Ensure
projectx-bridge, ox_lib, the K4MB1 Maze Bank map, mka-lasers, and all minigames from the install zip (SN-Hacking, simonsays, lightsout, utk_fingerprint, pure-minigames, pd-safe) are started before projectx-mazebankrobbery-k4mb1 in server.cfg.