Skip to main content
Most problems show themselves in the server console or the F8 client console — filter for [nex_donatorsystem] first.

Tebex / redemption

ProblemFix
Tebex API returned status 404The 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.
This order has been refunded or charged backWorking as intended — the buyer reversed payment. They keep nothing.
This order has already been redeemedEach 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 currencyThe 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.

Admin access

ProblemFix
Admin tab missing from the sidebarYour license: isn’t in Config.Admins. Look it up via tx admin lookup <name> or getplayerlist.
/givecoins / /setcoins say “No permission” in chatSame fix — license not in Config.Admins. Console runs are always allowed.

Delivery

ProblemFix
Failed to register vehicleThe insert into player_vehicles failed. Make sure your framework’s player_vehicles table exists and matches the standard schema.
Items don’t land in inventoryox_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 keysEither no keys script is detected, or you’ve set Config.GiveVehicleKeys = false. List of supported keys scripts is in Configuration → Vehicle keys.
Item card has no imageThe 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

ProblemFix
Slow down. Try again in a few seconds.Anti-spam protection. Wait and retry.
Theme changes don’t stickThey’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 seeOther 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.