> For the complete documentation index, see [llms.txt](https://shredded.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shredded.gitbook.io/docs/paid-scripts/shr-pawnshop/troubleshooting.md).

# TROUBLESHOOTING

## Menu does not open

* Confirm **ox\_target** is running and the player is in range
* If using NPC: wait a few seconds after join for spawn (up to 5 retries)
* Check F8/client console for `[pawnshop_raw] Failed to spawn NPC`
* Try `npc.enabled = false` and use a box zone to isolate NPC issues

## Empty menu (“You don't have any items…”)

* Item must exist in **`Config.Items`**
* Player must have **at least 1** of that item in inventory
* Item name must match qs-inventory / ox\_inventory exactly

## Progress bar does not start

* Ensure **progressbar** resource is started: `ensure progressbar`
* Notification: *Progress bar resource is not running!*

## No money after sale

* Check `Config.MoneyAccount` matches your ESX setup
* Verify `es_extended` is loaded and player has a valid `xPlayer`
* Check server console for `[pawnshop_raw]` sale log line

## Wrong or missing item images

* Set `Config.Inventory` correctly
* Ensure `itemname.png` exists in the inventory images folder
* Adjust `Config.ImageExt` if you use `.webp` etc. (path must match inventory)

## Sale cancelled but items gone / duplicate pay

* Do not change progress duration on live servers without matching server timeout
* Server pays out after `Config.Progress.duration` (or `SellDuration`) + 300 ms buffer

## Locale not loading

* File must define `_G.Locales["code"]` with the same code as `Config.Locale`
* File must be listed in `fxmanifest.lua` **before** `locale.lua`

## Webhook not sending

* `enabled = true` and valid `url`
* Discord webhook not deleted or rate-limited
* Sale must complete successfully (not cancelled)

## Restart / cleanup

On `stop shr_pawnshop`, blips, zones, and NPCs are removed. If players are stuck frozen, restart the resource — `onResourceStop` clears menu freeze and inventory lock.