> ## 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 Default Fleeca Bank Robbery 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 Default Fleeca Bank Robbery, the `projectx-bridge` asset is automatically delivered to your CFX portal.
  </Accordion>

  <Accordion title="What inventory systems are supported?">
    Inventory is handled through the Project X Bridge. Set `Inventory` to `'auto'` in the bridge config for automatic detection. Supported values include ox\_inventory, qb-inventory, ps/lj-inventory, codem-inventory, origen\_inventory, tgiann-inventory, ak47\_inventory, jpr-inventory, one\_inventory, and ESX default inventory. See the [FAQs](/faqs) for the full list with config values and links.
  </Accordion>

  <Accordion title="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](/faqs) for the full list with config values and links.
  </Accordion>

  <Accordion title="How many Fleeca locations are included?">
    Six locations: RockfordHills, Legion, Burton, Alta, GrandSenoraDesert, and BanhamCanyon. Enable or disable each one in `Config.FleecaLocations`.
  </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 available at the end. The loud approach is lower risk with a fixed trolley count controlled by `StrikeLoud`, but may trigger dispatch immediately.
  </Accordion>

  <Accordion title="How do I change which minigames are used?">
    Open `opensource/client/client.lua` and find the `projectx-fleecabankrobbery-default: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/fleeca-bank-robbery-default/opensource) page for the full callback code and a table of the default minigame assignments.
  </Accordion>

  <Accordion title="How do I reset a bank manually?">
    Use the `/projectxfleeca` in-game command (requires admin permissions) to reset the nearest bank within 50m, or call the `Reset(location)` server export from another resource:

    ```lua theme={null}
    exports['projectx-fleecabankrobbery-default']:Reset('RockfordHills')
    ```

    See the [Commands](/resources/fleeca-bank-robbery-default/commands) and [Exports](/resources/fleeca-bank-robbery-default/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 robbery 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](/faqs) for bridge XP config values.
  </Accordion>

  <Accordion title="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. Bonus drops are off by default.

    ```lua theme={null}
    Bonus = {
        Status = true,
        BonusChance = 15,
        ItemCount = 1,
        Items = {
            {Name = "x_device", Chance = 30, Amount = {min = 1, max = 1}},
            {Name = "x_phone", Chance = 50, Amount = {min = 1, max = 1}},
            {Name = "x_stethoscope", Chance = 20, Amount = {min = 1, max = 1}},
        }
    }
    ```
  </Accordion>

  <Accordion title="How do I use global vs per-location cooldowns?">
    Set `Cooldown.Global` to `true` to lock all Fleecas when one is robbed. Set it to `false` for individual per-location cooldowns. Adjust the duration with `Cooldown.Timer` (in minutes).
  </Accordion>

  <Accordion title="How do I enable or disable specific Fleeca banks?">
    Toggle each location in `Config.FleecaLocations`:

    ```lua theme={null}
    Config.FleecaLocations = {
        ["RockfordHills"] = true,
        ["Legion"] = true,
        ["Burton"] = false,
        ["Alta"] = true,
        ["GrandSenoraDesert"] = true,
        ["BanhamCanyon"] = true,
    }
    ```
  </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` (`ox_lib`, `projectx-bridge`, then minigames, then the robbery script).
  </Accordion>

  <Accordion title="Minigames fail immediately" icon="triangle-exclamation">
    Verify all minigame resources (`SN-Hacking`, `utk_fingerprint`, `simonsays`, `lightsout`, `pd-safe`) are started and placed outside the robbery script folder. The bridge's `MinigameCheck` will return `false` if a minigame resource is missing.
  </Accordion>
</AccordionGroup>