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

# Troubleshooting

> Most problems show themselves in the server console or the F8 client console — filter for [nex_donatorsystem] first.

Most problems show themselves in the **server console** or the **F8 client console** — filter for `[nex_donatorsystem]` first.

## Tebex / redemption

| Problem                                               | Fix                                                                                                                                                                                                                                                  |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Tebex API returned status 404`                       | The order ID couldn't be found by Tebex. Double-check it's the full `tbx-xxxxxx-xxxxxx` string, that `sv_tebexSecret` matches the store the player bought from, and that the order has finished processing (give it a minute after checkout).        |
| `Tebex secret not configured (sv_tebexSecret convar)` | You haven't set the secret. Add `sv_tebexSecret "..."` to your `server.cfg` above `ensure nex_donatorsystem` and restart. See [Tebex setup](/nex_donatorsystem/tebex-setup#step-1--set-your-tebex-secret).                                           |
| `This order has been refunded or charged back`        | Working as intended — the buyer reversed payment. They keep nothing.                                                                                                                                                                                 |
| `This order has already been redeemed`                | Each Tebex order can only be redeemed once. If a player insists they didn't, check the `nex_donatorsystem_redeems` table — the redeemer's identifier is recorded.                                                                                    |
| Order redeems for 0 currency                          | The package ID isn't in `ServerConfig.CoinPackages` and `ServerConfig.CoinPerDollar` is `0`. Either add the package to the map, or set a fallback rate. See [Tebex setup → Step 3](/nex_donatorsystem/tebex-setup#step-3--map-packages-to-currency). |

## Admin access

| Problem                                                | Fix                                                                                                   |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| Admin tab missing from the sidebar                     | Your `license:` isn't in `Config.Admins`. Look it up via `tx admin lookup <name>` or `getplayerlist`. |
| `/givecoins` / `/setcoins` say "No permission" in chat | Same fix — license not in `Config.Admins`. Console runs are always allowed.                           |

## Delivery

| Problem                           | Fix                                                                                                                                                                                                                                                            |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Failed to register vehicle`      | The insert into `player_vehicles` failed. Make sure your framework's `player_vehicles` table exists and matches the standard schema.                                                                                                                           |
| Items don't land in inventory     | `ox_inventory` isn't started, or you've forced `Config.Inventory` to a script that isn't running. Set `Config.Inventory = 'auto'` and let the script pick. Check F8 for the active inventory bridge on resource start.                                         |
| Vehicle spawns but I have no keys | Either no keys script is detected, or you've set `Config.GiveVehicleKeys = false`. List of supported keys scripts is in [Configuration → Vehicle keys](/nex_donatorsystem/configuration#vehicle-keys).                                                         |
| Item card has no image            | The admin didn't set an image URL **and** the auto-built path doesn't resolve. Set `Config.ItemImagePath` to your inventory's image folder (`nui://qb-inventory/html/images/`, `nui://ps-inventory/html/images/`, etc.), or set explicit URLs on each package. |

## UI / general

| Problem                                     | Fix                                                                                                                                     |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `Slow down. Try again in a few seconds.`    | Anti-spam protection. Wait and retry.                                                                                                   |
| Theme changes don't stick                   | They're saved per-server in the `nex_donatorsystem_settings` table. If they revert on restart, check the server console for SQL errors. |
| Customize UI changes one client doesn't see | Other clients pick up the new theme on next shop open. Have them close and re-open the shop.                                            |

## Database

The schema is idempotent and re-verifies on every boot. You should see this in the console at start-up:

```
[nex_donatorsystem][schema] 7/7 tables verified, 4 default categories seeded.
[nex_donatorsystem] Loaded N items, N categories, N deals.
```

If you see fewer than 7/7 tables verified, your MySQL user is missing `CREATE` permission on the database — grant it and restart. The seven tables are:

```
nex_donatorsystem
nex_donatorsystem_items
nex_donatorsystem_categories
nex_donatorsystem_purchases
nex_donatorsystem_deals
nex_donatorsystem_codes
nex_donatorsystem_redeems
nex_donatorsystem_settings
```

## Before opening a support ticket

Please include:

1. Server console output filtered for `[nex_donatorsystem]`.
2. F8 client console output filtered for `[nex_donatorsystem]`.
3. Your framework (Qbox / QBCore / ESX), inventory, and keys script.
4. The order ID (for Tebex issues) — never share your `sv_tebexSecret`.
5. What you did and what you expected to happen.

See [Support & contact](/general/support).