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

# troubleshooting

### No NPC spawning

* Confirm `Config.NPC.coords` is a valid `vector4`.
* Make sure the resource started after its dependencies in `server.cfg`.
* Check the model name is correct and streamed.

### Missing images in the menu

The folder must be named exactly `5code-loadouts`. Rename it back if you changed it.

### Deploy fails silently

* Verify the items in the loadout exist as registered inventory items.
* Confirm the officer has enough money in their **bank** (not cash) for the deposit.

### Database errors on start

* Make sure oxmysql is started before 5Code Loadouts.
* Confirm your oxmysql connection string is correct.

### Stuck deployment

If a deployment cannot be closed normally, an admin can run:

```
/loadouts:forceclose <citizenid> [refund|penalty|none]
```

### Wrong framework detected

If auto-detection picks the wrong framework, pin it:

```lua
Config.Framework = 'qb-core' -- or 'qbx_core' / 'esx'
```

### No notifications on ESX

Set `Config.NotifySystem` to either `'esx'` or `'ox_lib'`. The default may not match your server.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://5code.gitbook.io/5code-docs/5code-loadouts/reference/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.