Common problems

#Coin rewards fail and the console says "Coin rewards require oxmysql 2.12.0 or newer"

Coin rewards in Playtime and Battle Pass need oxmysql 2.12.0 or newer. Update oxmysql and restart the server. The reward stays unclaimed, so the player can claim it again afterwards.

#A player claimed a coin reward but nothing changed on Tebex

Coin rewards go to the in-game coin balance shown in the store header. They are not Tebex credit. Each reward can be claimed once per player.

#Playtime or battle pass rewards disappear after a restart

Versions before 1.0.4 deleted item rewards when the inventory was not ready at start. Update to the latest version from the Cfx.re portal and start gg_coinshop after your inventory. Rewards that were already deleted do not come back: create them again or restore them from a database backup.

#The console says "Item definition unavailable; preserving product"

The Coin Shop could not read that item from your inventory, so it kept the product without changing it. Check that gg_coinshop starts after your inventory and that the item name on the product exists in your inventory.

Products that really disappear were deleted by the auto-remove options for expired or out-of-stock products under Settings > Store.

#Item images are missing or wrong

The Coin Shop uses the first supported inventory it finds on your server, and a stopped one counts. Set your inventory in gg_coinshop/utility.lua, for example:

inventory = "one_inventory",

Use your inventory's resource name, then restart gg_coinshop.

#Vehicles from the Coin Shop get a random plate and cannot be parked

This is a known issue in the current release. The Coin Shop saves bought and won vehicles without the plate inside their vehicle properties. Garages that set the plate from those properties, such as VMS Garages, spawn the car with a random plate and then say the player does not own it.

Open a ticket in the Discord with your garage script's name and we will help you fix the saved cars.

#Battle pass challenges never progress

A challenge only counts when a script calls the challenge export with its key. Advanced Bus Job and Advanced Hunting send theirs out of the box. For any other key, add the export to the script that should count it, see Exports. If you do not use challenges, turn them off under Settings > Battle Pass.

#"No such export AddCoins" in another script

The AddCoins and RemoveCoins exports were added in 1.0.4. Install the full latest gg_coinshop from the Cfx.re portal, not an older single-file fix. Call the exports from server scripts only.

#Another script needs to run when a player buys a product

The Coin Shop does not send a purchase event or hook to other scripts. Products deliver an item, a vehicle or a job. To charge coins inside your own script, use RemoveCoins.

#Weapon skins sold in the store do nothing

The Coin Shop gives the item. It does not apply skins. A skin product works only if the item is already usable and handled by your inventory or skin script. Test it on a test server before you sell it.

#Tebex coins did not arrive

Open Admin Panel > Transactions. If the purchase shows as Unredeemed, the buyer had not joined your server with that Cfx.re account yet. They open the store, click Redeem Code and enter the Tebex transaction ID that starts with tbx-.

If the purchase is not listed at all, the command did not reach your server. Check the package's command against Create Tebex package.