Help

Troubleshooting and FAQ

Vouchers do not create codes, and chat says the Tebex key is not set.

Put your Tebex secret key in tebex.secret-key in plugins/HyperCredits/config.yml and run /hc reload. Then run /hc status to confirm the connection. For more detail, set debug: true to print every Tebex request and response to the console (the key is never printed).

Redeeming failed with "your voucher was returned".

Tebex rejected or did not answer the request. The voucher is given back so nothing is lost. Check the console and /hc status, then try again. You can raise tebex.timeout-seconds if your server's connection to Tebex is slow.

I get "Unknown Tebex package/category" with effective_on.

The name must match a package or category in your Tebex store. Run /hc refresh if you just added it, then use tab-complete after effective_on:.

Why can I not give a gift card over $495?

Tebex refuses gift cards worth more than $495, so the plugin stops it before the request. With HyperCredits+ you can hold a larger Credits balance, but each withdrawal is capped at 495.

"A percentage coupon can't be more than 100%".

Use discount:value for a fixed amount off, for example /hc give Steve COUPON 5 default discount:value.

A player says a voucher cannot be dropped or stored.

That is the anti-dupe protection. Players can send vouchers with Shift + right-click instead. Allow dropping only if you accept the risk, with drop-trade: true.

A player's inventory was full when they got a voucher.

It waits in /giftcards claim. They are told in chat and again on join.

I got an ANTI-DUPE alert.

A player tried to redeem a voucher whose ID was already redeemed. The copy is removed and the attempt is logged. Staff with hypercredits.notify.dupe see the alert, and it goes to Discord if enabled.

/credits does not do what I expect.

Without HyperCredits+, /credits is only an alias of /hc. With HyperCredits+ it opens the wallet. HyperCredits+ command names can be changed in its config and need a restart.

The update checker says nothing.

It only runs for copies downloaded from BuiltByBit. The check runs on startup and every 24 hours by default, and tells the console and admins with hypercredits.admin.

The web panel link says it is disabled.

The panel is off by default. Set enabled: true in plugins/HyperCreditsPlus/web.yml and run /hcp reload.

Support.

Join the Discord linked on the BuiltByBit page. Include your server version, the output of /hc status and any console errors.