Reference

HyperCredits+ features

Everything in this section needs the HyperCredits+ add-on (version 1.0.3 documented).

Two currencies#

Credits are withdrawn as Tebex gift cards. Coupons are withdrawn as fixed-value Tebex coupons. Names, symbols, prefixes and the amount format are configurable. Amounts read like 1,000 Credits and whole numbers drop the .00.

Wallets#

/credits and /coupons open a wallet for each currency, with the balance, rank, codes already withdrawn, and buttons for withdraw, leaderboard and switching currency. Codes the player created before stay in the wallet.

Withdrawing#

  • Pick a preset amount, withdraw all, or type a custom amount on a sign (or in chat).
  • Or use /credits withdraw <amount|all> directly.
  • The balance is taken first. If Tebex fails, it is refunded.
  • Credits withdrawals are capped at 495, a Tebex limit, even if the config says more. Coupons have no cap.
  • A cooldown (30 seconds by default) applies between withdrawals.

Paying players#

/credits pay <player> <amount>, or /credits pay for a menu. Paying Credits is on by default and paying Coupons is off by default.

Leaderboards#

/credits top and /coupons top open a leaderboard menu. Placeholders expose the top players for scoreboards and holograms.

Transaction log#

Every balance change is written to plugins/HyperCreditsPlus/logs/transactions-YYYY-MM.log.

Storage#

Balances are stored in YAML by default. Set storage.type: "mysql" to use MySQL.

Giving balance from Tebex packages#

hc give {username} GIFTCARD 10        (uses the HyperCredits template and effects)
credits give {username} 10            (plain deposit)
credits give {username} 10 -s         (plain deposit, no message)
hcp give {username} coupons 5