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

# Troubleshooting

> Resolve startup, integration, clerk, minigame, reward, and Asset Escrow problems.

Start with the first console error. Later errors often result from the same missing dependency or invalid configuration.

<AccordionGroup>
  <Accordion title="The resource does not initialize" icon="triangle-exclamation">
    Confirm `ox_lib` 3.30.6 or later starts before `fa_shoprobbery`. Fix every validator error printed with `[fa_shoprobbery][validator:server]` or `[fa_shoprobbery][validator:client]`.

    If you selected an explicit integration, confirm its exact resource name is started first.
  </Accordion>

  <Accordion title="Asset Escrow reports an entitlement error" icon="key">
    A resource-folder rename does not itself cause an Asset Escrow entitlement error. Confirm your server license key belongs to an account with access to the asset. Then confirm `server.cfg`, external export calls, and integrations use the resource's current folder name. See [Asset Escrow](/basic-knowledge/asset-escrow) for the full checklist.
  </Accordion>

  <Accordion title="A minigame does not open" icon="gamepad">
    Start `fa_minigames` before `fa_shoprobbery` when `Config.Minigames.Safe = 'fa_minigames'`. A keypad falls back to an `ox_lib` input dialog when its bundled export cannot start. Drill requires `fa_minigames` or a custom adapter.
  </Accordion>

  <Accordion title="A player receives no reward" icon="sack-dollar">
    Confirm the item exists, the selected inventory adapter matches the running resource, and the player has capacity. Review the server console for adapter or capacity errors.

    In standalone mode, confirm `ServerConfig.StandaloneMoneyItems` points to valid inventory items.
  </Accordion>

  <Accordion title="Two clerks appear" icon="people-group">
    Another shop resource is probably spawning its own ped. For official QB-Shops v1.5.0, install the supplied replacement from the [integration guide](/scripts/shop-robbery/integrations#qb-shops-v150). For forks, use the clerk lifecycle API and disable their duplicate ped creation.
  </Accordion>

  <Accordion title="Police receive no alert" icon="tower-broadcast">
    Confirm `Config.Dispatch` matches a started resource. Check the installed dispatch version and its exports. Then trigger a new robbery after resetting the store.
  </Accordion>

  <Accordion title="A store remains on cooldown" icon="clock">
    Cooldowns are runtime-only. Use `/resetstore store_id` or `/resetstores` with an authorized admin group. Verify you are using the store's `id`, not its display label.
  </Accordion>

  <Accordion title="The safe prop is duplicated after a restart" icon="vault">
    Allow the client cleanup and server reconciliation to complete, then inspect the console for duplicate-safe cleanup output. Confirm the resource folder and deployed files match the same release. Test restart behavior with multiple nearby clients before production use.
  </Accordion>
</AccordionGroup>

## What to include in a support request

* FA Shop Robbery version
* Framework and exact resource name
* Inventory, target, dispatch, and minigame selections
* Relevant third-party resource versions
* Complete first server and client console error
* Steps that reproduce the problem

Share the report in [FA Scripts Discord](https://discord.gg/ePYv5V5b8w). Remove webhook URLs, API keys, license keys, and other secrets before posting logs.