> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectx.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQs

> Frequently asked questions about the K4MB1 Casino Heist resource

## General Questions

> [accordion] What frameworks are supported?
>
> QBCore, Qbox, and ESX are supported through **projectx-bridge**. Set `Framework` to `'auto'` in the bridge config.
>
> Custom frameworks work if you implement the bridge adapters and set `Framework` to `'custom'`. See the [Bridge Overview](https://docs.projectx.gg/resources/bridge/overview.md).

> [accordion] Do I need the Project X Bridge?
>
> Yes. The bridge is required for framework, inventory, dispatch, notifications, XP, evidence, logs, and permissions. See [Bridge Installation](https://docs.projectx.gg/resources/bridge/installation.md).
>
> `projectx-bridge` is included with your CFX purchase.

> [accordion] What dispatch systems are supported?
>
> The bridge supports **30+** dispatch systems. Set `Dispatch` to `'auto'` in the bridge config. See [FAQs](https://docs.projectx.gg/faqs.md) for the full list with config values and links.

> [accordion] What is the difference between loud and silent approaches?
>
> **Silent** — higher reward potential (`TotalTrollys` up to 12). Failed minigames add **strikes**; reaching `Strikes` removes `StrikeAmount` trolleys.
>
> **Loud** — fixed payout: `StrikeLoud` trolleys spawn regardless of strikes. Dispatch can fire immediately when loud starts (`DispatchLocation.Loud`).

> [accordion] Can I run the heist solo?
>
> Set `Disable2PlayerPuzzles` to `true` in `config/config.lua` to disable two-player fusebox puzzles.

> [accordion] How do I disable the penthouse?
>
> Set `DisablePenthouse` to `true` in `config/config.lua`.

> [accordion] How do I change minigames?
>
> Edit `opensource/client/client.lua` — callback `projectx-casinoheist-k4mb1:client:Minigames`. See [Open Source](https://docs.projectx.gg/resources/casino-heist-k4mb1/opensource.md) for the full step table.

> [accordion] How do I reset the heist manually?
>
> Use `/projectxcasino` (admin), or:
>
> ```lua theme={null}
> exports['projectx-casinoheist-k4mb1']:Reset()
> ```
>
> See [Commands](https://docs.projectx.gg/resources/casino-heist-k4mb1/commands.md) and [Exports](https://docs.projectx.gg/resources/casino-heist-k4mb1/exports.md).

## Configuration Questions

> [accordion] How do I require a minimum number of police?
>
> Set `MinimumPolice` and `PoliceJobs` in `config/config.lua`.
>
> ```lua theme={null}
> MinimumPolice = 2,
> PoliceJobs = {"police", "fbi"},
> ```

> [accordion] How do I gate the heist behind XP or level?
>
> Set `SkillSystem` to `true` and `MinimumLevel` in `config/config.lua`. Configure `XPSystem` in the bridge (including **projectx-xp**, `pickle_xp`, `sd-levels`, `cw-rep`, `OT_skills`). See [FAQs](https://docs.projectx.gg/faqs.md) for bridge XP values.

> [accordion] How do I configure bonus items?
>
> Enable `Bonus.Status` and edit `Bonus.Items` in `config/config.lua`. Each entry has `Name`, `Chance`, and `Amount` min/max.

## Troubleshooting

> [accordion] The script won't start
>
> Ensure **ox\_lib**, **projectx-bridge**, **mka-lasers**, and all minigames from the zip are started before `projectx-casinoheist-k4mb1`. This resource includes `@mka-lasers/client/client.lua` in its manifest.

> [accordion] Lasers do nothing or errors mention mka-lasers
>
> Install and `ensure mka-lasers` before the heist resource.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.