> ## 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 Bobcat Heist resource

## General Questions

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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](/resources/bridge/installation) page for setup instructions.

    When you purchase Bobcat Heist, the `projectx-bridge` asset is automatically delivered to your CFX portal.
  </Accordion>

  <Accordion title="What dispatch systems are supported?">
    The bridge supports 25+ dispatch systems including PS Dispatch, CodeSign, LB Tablet, FD Dispatch, Wasabi MDT, Sonoran CAD, and many more. Set `Dispatch` to `'auto'` in the bridge config for automatic detection. See the [Bridge Overview](/resources/bridge/overview) for the full list.
  </Accordion>

  <Accordion title="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, which reduce the number of trolleys and crates available at the end. The loud approach is lower risk with fixed counts controlled by `StrikeLoud` and `CrateStrikeLoud`.
  </Accordion>

  <Accordion title="How do I change which minigames are used?">
    Open `opensource/client/client.lua` and find the `projectx-bobcatheist-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](/resources/bobcat-heist-k4mb1/opensource) page for the full callback code and a table of the default minigame assignments.
  </Accordion>

  <Accordion title="How do I reset the heist manually?">
    Use the `/projectxbobcatk4mb1` in-game command (requires admin permissions), or call the `Reset()` server export from another resource:

    ```lua theme={null}
    exports['projectx-bobcatheist-k4mb1']:Reset()
    ```

    See the [Commands](/resources/bobcat-heist-k4mb1/commands) and [Exports](/resources/bobcat-heist-k4mb1/exports) pages for more details.
  </Accordion>
</AccordionGroup>

## Configuration Questions

<AccordionGroup>
  <Accordion title="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`.

    ```lua theme={null}
    MinimumPolice = 2,
    PoliceJobs = {"police", "fbi"},
    ```
  </Accordion>

  <Accordion title="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 `pickle_xp`, `sd-levels`, `cw-rep`, and `OT_skills`.
  </Accordion>

  <Accordion title="How do I configure security guards?">
    Edit the `SecurityGuards` table in `config/config.lua`. Each entry supports `Status`, `Model`, `Coords`, `Weapon`, and `Ammo`. Global ped behavior is controlled by `SecurityOptions`.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The script won't start" icon="triangle-exclamation">
    Make sure you have all required dependencies started before the script in your `server.cfg` (`projectx-bridge`, `ox_lib`, `mka-lasers`, and minigames).
  </Accordion>
</AccordionGroup>