#Overview
HyperCredits turns Tebex gift cards and coupons into real in-game items. You give a player a voucher with one command (or from a Tebex package). They right-click it, and the plugin creates the gift card or coupon code on your Tebex store at that moment.
- Gift card vouchers create a Tebex gift card with the amount you chose.
- Coupon vouchers create a Tebex coupon, as a percentage or a fixed amount, optionally limited to one package or category.
- Every code a player redeems is kept in the
/giftcardsmenu, so nobody has to copy codes into DMs. - Vouchers are protected against duplication, can be traded between players, and can expire.
An optional paid add-on, HyperCredits+, turns vouchers into a Credits and Coupons balance with wallets, withdrawals, payments, leaderboards and a web admin panel. See the HyperCredits+ section below.
The plugin talks to the Tebex Plugin API with your store's secret key. Without a key, vouchers cannot create codes.
#Installation
Requirements
- Spigot, Paper or a fork, 1.17 or newer (the plugin declares
api-version: 1.17). - Java 17 or newer.
- A Tebex store and its game server secret key.
- PlaceholderAPI is optional and only needed for placeholders.
Install
- Put
HyperCredits-1.0.7.jarin your server'splugins/folder. - Restart the server. Do not use
/reload. - Open
plugins/HyperCredits/config.ymland settebex.secret-key. In your Tebex dashboard it is under Integrations, Game Servers, edit your server, Secret Key. - Run
/hc reload, then/hc status. The status page shows the mode, the Tebex connection and how many packages were loaded.
Admins with hypercredits.admin get a chat reminder when they join if the secret key is still not set.
Files created in plugins/HyperCredits/:
| File | What it holds |
|---|---|
config.yml | Tebex key, server info, coupon and gift card defaults, trading, instant claim, confirmation, updater. |
templates.yml | The look and effects of every voucher template (10 included). |
messages.yml | Every message the plugin sends. |
discord.yml | Discord webhook logging. |
gui/*.yml | The five menus: claim, confirm, history, trade and vouchers. |
data.yml, redeemed.yml | Player voucher data and the list of already redeemed voucher IDs (the anti-dupe list). |
#Giving vouchers
Admins give vouchers with /hc give (one player) or /hc giveall (everyone online). Both work from the console, so Tebex package commands can run them.
/hc give <player> <GIFTCARD|COUPON> <amount> [template] [time|infinite] [key:value ...] [-s]
/hc giveall <GIFTCARD|COUPON> <amount> [template] [time|infinite] [key:value ...] [-s]
Everything after the amount is optional and can be in any order:
- template: a template name from
templates.yml. Default isdefault. Tab-complete lists the templates for the voucher type. - time: when the voucher expires, as
30m,12h,7d,2w, or a plain number of days.infinite(ornever) means no expiry, which is the default. - discount:value or discount:percentage (coupons): fixed amount off, or percentage. Defaults to
coupon-settings.discount_type. - effective_on:name (coupons): limit the coupon to a package or category using the names from your store. Separate several with commas. Names are tab-completed from the Tebex cache.
- -s (or
silent): give the voucher without the chat message to the player.
Examples
/hc give Steve GIFTCARD 10
/hc give Steve GIFTCARD 25 premium 30d
/hc give Steve COUPON 10
/hc give Steve COUPON 10 flash 7d effective_on:vip
/hc give Steve COUPON 5 default discount:value
/hc giveall GIFTCARD 5 holiday 24h
Rules the plugin checks
- Amounts must be greater than 0.
- A percentage coupon cannot be more than 100.
- A gift card voucher cannot be worth more than $495, because Tebex rejects larger gift cards.
- The template must exist, and unknown package or category names are rejected. Run
/hc refreshafter adding a package to your store.
If the player is offline, the voucher waits for them in /giftcards claim and they are told when they join.
From a Tebex package
Add a game server command to the package, for example:
hc give {username} GIFTCARD 10
hc give {username} COUPON 15 default 7d effective_on:vip_rank
With instant-claim: true, no item is given. The code is created right away and goes straight into the player's /giftcards menu.
#Redeeming and trading
Redeeming
The voucher is an item (paper by default). Right-click it to redeem. By default a confirmation menu opens first. When the player confirms, the plugin takes the item, asks Tebex to create the code, then shows it in chat and stores it in /giftcards. If Tebex fails, the voucher is given back.
The Tebex code is created only at redeem time, so each voucher always becomes exactly one code.
- Expired vouchers cannot be redeemed. With
remove-expired-vouchers: truethey are removed from the inventory when someone tries. - A voucher can only be redeemed by its owner.
- Confirmation can be skipped for small vouchers with
redeem-confirmation.skip-threshold.
On redeem effects
Each template can show a title, play a sound, launch a firework and run console commands when the voucher is redeemed. See Voucher templates.
Trading
With trade-vouchers: true (default), a player holds the voucher and does Shift + right-click to send it to another player, even an offline one. The target claims it from /giftcards claim. Turn trading off and vouchers can only be used by the original owner.
With drop-trade: true vouchers can also be dropped and picked up by other players, and stored in chests. This is less secure and not recommended.
#Voucher templates
templates.yml defines how vouchers look and what happens when they are redeemed. Ten templates are included: gift cards default, premium, vip, holiday, and coupons default, premium, seasonal, flash, vip, holiday.
Each template supports:
item: the material of the voucher item.nameandlore: colored with&codes. Placeholders include{amount},{expires}and, for coupons,{effective_on}.lore_effective_on(coupons): the lore used when the coupon is limited to a package or category.glowandcustom-model-data: optional glint and resource pack model.effects:title,sound,fireworkandcommandsshown or run on redeem.{player}works in commands.
The included default gift card template:
giftcards:
default:
item: PAPER
name: '&a&lGIFT CARD &8• &6${amount}'
lore:
- ''
- '&7━━━━━━━━━━━━━━━━━━━━━━━'
- ''
- ' &7Store Credit: &a&l${amount}'
- ' &7Valid Until: &e{expires}'
- ' &7Status: &a✔ Active'
- ''
- ' &e&l➤ &eRIGHT-CLICK TO REDEEM'
effects:
title:
enabled: true
main: '&a&lGift Card Redeemed!'
sub: '&7Enjoy your &6${amount} &7credit'
sound:
enabled: true
name: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
firework:
enabled: true
power: 1
commands:
- 'say &a{player} &7redeemed a gift card worth &6${amount}&7!'
(The lore above is shortened. The file has a longer description block.)
Copy any template, give it a new name, then use that name in /hc give. Coupon templates also accept discount_type: PERCENTAGE to set their default type.
#Anti-dupe and safety
Vouchers are meant to be worth real money, so they are protected.
- Every voucher has a unique ID that can be redeemed only once. Redeemed IDs are saved in
redeemed.yml. - The item is taken from the inventory before Tebex is called, only one redeem per voucher runs at a time, and the item is returned if Tebex fails.
- A copied voucher is detected, the copy is removed, and staff with
hypercredits.notify.dupeget an alert in chat. The attempt also goes to Discord if enabled. - Vouchers cannot be dropped, placed as blocks, put in item frames or stored in chests, hoppers, barrels or shulkers (unless
drop-tradeis on). - Vouchers stay with the player when they die.
- Pickups of someone else's dropped voucher are blocked.
#Discord logging
Set a webhook URL in plugins/HyperCredits/discord.yml to log voucher activity. Each event has its own embed that you can edit or turn off:
gift card created, claimed, expired and transferred; the same for coupons; duplication attempts; and a statistics summary. With HyperCredits+ installed there are also embeds for withdrawals, deposits, payments and admin balance changes.
enabled: true
webhook-url: "YOUR_WEBHOOK_URL_HERE"
bot-name: "HyperCredits"
# Show only the last 4 characters of codes in Discord
hide-codes: false
Codes are real money. Use a private channel, or set hide-codes: true.
#Commands
Admin commands also work from the console. /hc and /hypercredits are the same command. Admin sub-commands are allowed with the specific permission, or with hypercredits.admin.
| Command | What it does | Permission |
|---|---|---|
| /hypercredits | Shows the help page. Aliases: /hc, /credits (with HyperCredits+ installed, /credits is the wallet). | |
| /hc give <player> <GIFTCARD|COUPON> <amount> [template] [time|infinite] [key:value ...] [-s] | Gives a voucher. Works for offline players. Options: discount:value|percentage, effective_on:name,name, -s. | hypercredits.give.giftcard or hypercredits.give.coupon |
| /hc giveall <GIFTCARD|COUPON> <amount> [template] [time|infinite] [key:value ...] [-s] | Gives a voucher to everyone online. | hypercredits.giveall |
| /hc history <player> | Opens a player's voucher history. Players only. | hypercredits.history |
| /hc vouchers <player> | Opens the list of codes a player has. Players only. Alias: /hc lookup. | hypercredits.history |
| /hc status | Shows the version, mode (standalone or credits), Tebex connection, cached packages, tracked redeemed vouchers, instant claim and trading. Alias: /hc info. | hypercredits.admin |
| /hc refresh | Reloads the package and category list from Tebex. | hypercredits.admin |
| /hc reload | Reloads config, messages, menus and Discord settings, then re-checks Tebex. | hypercredits.reload |
| /giftcards | Opens My Vouchers. Aliases: /coupons, /vouchers. No permission needed. | |
| /giftcards claim | Opens vouchers waiting for you. Alias: /giftcards pending. | |
| /giftcards giftcards | /giftcards coupons | Opens the menu on that tab. |
#Permissions
Players need no permissions for /giftcards or for redeeming and trading their vouchers.
| Permission | What it allows | Default |
|---|---|---|
| hypercredits.* | Everything in HyperCredits. | op |
| hypercredits.admin | All admin features, including /hc status and /hc refresh. Includes give, giveall, reload, history and notify.dupe. | op |
| hypercredits.give | Give vouchers of both types. | op |
| hypercredits.give.giftcard | Give gift card vouchers. | op |
| hypercredits.give.coupon | Give coupon vouchers. | op |
| hypercredits.giveall | Give a voucher to everyone online. | op |
| hypercredits.reload | Reload the configuration. | op |
| hypercredits.history | View any player's voucher history and codes. | op |
| hypercredits.notify.dupe | Get alerted about duplication attempts. | op |
#Placeholders
Needs PlaceholderAPI. The expansion identifier is hypercredits, so use %hypercredits_giftcards_amount%. Placeholders return a value only for online players. They count the codes stored in the player's /giftcards list.
| Placeholder | Value |
|---|---|
| %hypercredits_giftcards_amount% | Number of gift card codes the player has. |
| %hypercredits_giftcards_balance_total% | Total value of those gift cards, as a plain number. |
| %hypercredits_giftcards_balance_formatted% | Total value with a $ sign and two decimals. |
| %hypercredits_giftcards_active% | Gift cards that have not expired. |
| %hypercredits_giftcards_expired% | Gift cards that have expired. |
| %hypercredits_coupons_amount% | Number of coupon codes the player has. |
| %hypercredits_coupons_active% | Coupons that have not expired. |
| %hypercredits_coupons_expired% | Coupons that have expired. |
| %hypercredits_coupons_discount_total% | Sum of the coupon amounts, as a plain number. |
| %hypercredits_coupons_discount_formatted% | Sum of the coupon amounts followed by %. |
| %hypercredits_total_amount% | Gift cards plus coupons. |
| %hypercredits_total_active% | Active gift cards plus active coupons. |
| %hypercredits_total_expired% | Expired gift cards plus expired coupons. |
| %hypercredits_history_total% | Number of redeems in the player's history. |
| %hypercredits_history_giftcards_redeemed% | Gift cards redeemed. |
| %hypercredits_history_coupons_redeemed% | Coupons redeemed. |
| %hypercredits_history_last_redeem% | Date of the last redeem (MM/dd/yyyy), or Never. |
| %hypercredits_player_has_giftcards% | Yes or No. |
| %hypercredits_player_has_coupons% | Yes or No. |
| %hypercredits_player_has_active% | Yes if the player has any non-expired gift card or coupon. |
#Configuration
The main file is plugins/HyperCredits/config.yml. Run /hc reload after editing it.
Tebex and server
tebex:
secret-key: "YOUR_SECRET_KEY"
# Seconds to wait for Tebex before giving up (the voucher is returned on failure)
timeout-seconds: 15
server:
name: "My Server"
store-link: "https://your-store-link.com"
ip: "play.yourserver.com"
# Symbol used for gift card amounts and value coupons
currency-symbol: "$"
# Date format used in GUIs and messages (Java SimpleDateFormat)
date-format: "dd/MM/yyyy"
Gift cards and coupons
giftcard-settings:
# {player} = who redeemed it
note: "HyperCredits gift card for {player}"
coupon-settings:
# "percentage" or "value" (can be overridden per voucher with discount:value)
discount_type: "percentage"
note: "Created via HyperCredits for {player}"
# Prefix for generated coupon codes
code-prefix: "HC-"
# single, subscription or both
basket-type: "both"
# 0 = discount each package, 1 = discount basket before sales, 2 = discount basket after sales
discount-application-method: 0
# Minimum basket value required to use the coupon (0 = none)
minimum-basket: 0
# Lock the coupon to the Minecraft username of the player who redeemed it
lock-to-player: false
Behavior
trade-vouchers: true
drop-trade: false
instant-claim: false
remove-expired-vouchers: true
redeem-confirmation:
enabled: true
# vouchers worth this much or less skip the confirmation (0 = always confirm)
skip-threshold: 0.0
# Print every Tebex request/response to console (secret key is never printed)
debug: false
Updater
updater:
enabled: true
check-on-startup: true
check-interval-hours: 24
# Download new versions into plugins/update/. They install on the next restart.
# The current jar is backed up to plugins/HyperCredits/backup/ first.
auto-download: false
# Tell the console and admins (hypercredits.admin) about updates
notify: true
# Leave blank to use the built-in token
shared-token: ""
# 0 = HyperCredits (69795)
resource-id: 0
#HyperCredits vs HyperCredits+
HyperCredits+ is a separate, optional add-on sold on the same page. Put it next to HyperCredits and the two link by themselves, with nothing to configure. If you remove it, HyperCredits goes back to standalone mode on its own.
| HyperCredits only | With HyperCredits+ | |
|---|---|---|
/hc give <p> GIFTCARD 10 | Gives a voucher item. Redeeming it creates a Tebex gift card. | Adds 10 to the player's Credits balance. |
/hc give <p> COUPON 10 | Gives a voucher item. Redeeming it creates a 10% coupon. | Adds 10 to the Coupons balance (configurable). |
| Right-clicking an old voucher item | Creates the Tebex code. | Deposits the voucher into the balance. |
/giftcards | My Vouchers menu. | The HyperCredits+ wallet. |
/giftcards claim | Pending vouchers. | Still opens pending vouchers, so nothing is lost. |
| Players pay each other | No. | Yes. |
| Withdraw as a Tebex code any time | No, the code is made at redeem. | Yes. |
| Leaderboards and web panel | No. | Yes. |
The base plugin also keeps /giftcards legacy, which opens the original voucher menu so codes players already have stay one click away.
HyperCredits+ 1.0.3 requires HyperCredits 1.0.7. Update both together.
Use the HyperCredits+ section below for the full addon 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
#HyperCredits+ web panel
HyperCredits+ includes an admin panel in the browser. It runs inside the plugin, so you need no web host and no accounts. It is off by default.
- In
plugins/HyperCreditsPlus/web.ymlsetenabled: true, then run/hcp reload. - Run
/hcp web. You get a one-time login link in chat or console. - Open it. Locally the panel is at
http://127.0.0.1:8765by default.
The panel shows totals and a withdrawals-per-day chart, recent withdrawals, live activity, and status. You can search players, give, take or set balances, search and export withdrawals as a CSV file, and read every balance change in the transaction log.
enabled: false
host: "0.0.0.0"
port: 8765
# If empty, links use http://127.0.0.1:port
public-domain: ""
session-lifetime-minutes: 60
security:
tokens:
ttl-seconds: 300
max-pending: 10
single-use: true
allowed-ips: []
allowed-players: []
rate-limit:
enabled: true
window-seconds: 60
max-requests: 240
csrf:
enabled: true
The default host is 0.0.0.0, which listens on every interface. If you do not need remote access, set host: "127.0.0.1". For a public domain, put the panel behind a reverse proxy with HTTPS (the file includes NGINX and Caddy examples), set public-domain, and use security.allowed-ips or allowed-players to restrict access.
#HyperCredits+ commands
/credits and /coupons are the default names. Change them in currencies.*.command-name (a restart is needed). /credits also has the alias /wallet. The balance commands below are shown for /credits and work the same for /coupons. Admin sub-commands also work from the console.
| Command | What it does | Permission |
|---|---|---|
| /credits | Opens your wallet. | |
| /credits bal [player] | Shows your balance. With a player name, shows theirs. | hypercreditsplus.balance.others (for other players) |
| /credits top | Opens the leaderboard (the sub-command name is configurable). | |
| /credits withdraw [amount|all] | Opens the withdraw menu, or withdraws that amount as a Tebex code. | hypercreditsplus.withdraw |
| /credits pay [player] [amount] | Pays another player. With no arguments, opens a menu. | hypercreditsplus.pay |
| /credits help | Shows help. | |
| /credits give|add <player> <amount> [-s] | Adds balance. Sends the player a message unless -s is used. | hypercreditsplus.credits.admin |
| /credits take|remove <player> <amount> | Removes balance. | hypercreditsplus.credits.admin |
| /credits set <player> <amount> | Sets the balance. | hypercreditsplus.credits.admin |
| /credits reset <player> | Sets the balance to 0. | hypercreditsplus.credits.admin |
| /credits check <player> | Shows a player's balance. | hypercreditsplus.credits.admin |
| /coupons ... | The same sub-commands for the Coupons currency. Admin ones need hypercreditsplus.coupons.admin. | hypercreditsplus.coupons.admin |
| /hcp help | Admin help. Aliases: /hypercreditsplus, /hcreditsplus. | hypercreditsplus.admin |
| /hcp status | Shows versions, whether linked to HyperCredits, Tebex status, storage type, number of players and whether the web panel runs. Aliases: version, v. | hypercreditsplus.admin |
| /hcp reload | Reloads config, messages and menus, and restarts the web panel. Command names need a restart. | hypercreditsplus.admin |
| /hcp web | Creates a one-time login link for the web panel. Aliases: token, panel. | hypercreditsplus.admin |
| /hcp give|take|set|reset|check <player> <credits|coupons> [amount] | Balance admin commands for either currency from one command. | hypercreditsplus.admin |
#HyperCredits+ permissions
| Permission | What it allows | Default |
|---|---|---|
| hypercreditsplus.* | Everything in HyperCredits+. | op |
| hypercreditsplus.use | Basic player features. Includes withdraw and pay. | true |
| hypercreditsplus.withdraw | Withdraw balance as Tebex codes. | true |
| hypercreditsplus.pay | Pay other players. | true |
| hypercreditsplus.balance.others | See other players' balances. | op |
| hypercreditsplus.bypass.cooldown | Skip withdraw and pay cooldowns. | op |
| hypercreditsplus.admin | Give, take and set balances, web panel, reload, status. | op |
| hypercreditsplus.credits.admin | Manage Credits balances. | op |
| hypercreditsplus.coupons.admin | Manage Coupons balances. | op |
#HyperCredits+ placeholders
Identifier: hypercreditsplus. Replace credits with coupons for the other currency.
| Placeholder | Value |
|---|---|
| %hypercreditsplus_credits% | Balance as a plain number (same as _raw). |
| %hypercreditsplus_credits_formatted% | Balance in the configured format, for example 1,000 Credits. |
| %hypercreditsplus_credits_int% | Balance rounded down to a whole number. |
| %hypercreditsplus_credits_rank% | Leaderboard rank, or - if none. |
| %hypercreditsplus_credits_withdrawn% | Total the player has withdrawn, formatted. |
| %hypercreditsplus_credits_codes% | Number of codes the player has withdrawn. |
| %hypercreditsplus_credits_name% | The currency display name. |
| %hypercreditsplus_credits_symbol% | The currency symbol. |
| %hypercreditsplus_top_credits_1_name% | Name of the player at that leaderboard position (change the number). |
| %hypercreditsplus_top_credits_1_amount% | Balance of the player at that leaderboard position, formatted. |
#HyperCredits+ configuration
Main file: plugins/HyperCreditsPlus/config.yml. Menus are in gui.yml, messages in messages.yml, the web panel in web.yml.
currencies:
giftcards:
enabled: true
# Main command. Changing it needs a server restart.
command-name: "credits"
aliases: []
top-subcommand: "top"
display-name: "Credits"
symbol: "$"
# {amount} {name} {symbol}
format: "{amount} {name}"
prefix: "&8[&6Credits&8] &7"
coupons:
enabled: true
command-name: "coupons"
aliases: []
top-subcommand: "top"
display-name: "Coupons"
symbol: "⚡"
format: "{amount} {name}"
prefix: "&8[&dCoupons&8] &7"
withdraw:
# SIGN (sign editor, falls back to chat) or CHAT
input-method: "SIGN"
giftcards:
enabled: true
minimum: "1.00"
# Tebex gift cards can be worth at most 495
maximum: "495.00"
cooldown: 30
preset-amounts: ["1", "5", "10", "25", "50", "100", "250"]
coupons:
enabled: true
minimum: "1.00"
maximum: "10000.00"
cooldown: 30
preset-amounts: ["1", "5", "10", "25", "50", "100", "250"]
pay:
giftcards:
enabled: true
minimum: "0.01"
cooldown: 3
coupons:
enabled: false
minimum: "0.01"
cooldown: 3
integration:
giftcards-vouchers-to-balance: true
# Set false to keep percentage/package-restricted coupons as normal HyperCredits codes
coupons-vouchers-to-balance: true
take-over-base-commands: true
tebex:
giftcards:
note-prefix: "HyperCredits+ Credits"
expire-days: 0
coupons:
note-prefix: "HyperCredits+ Coupon"
expire-days: 0
discount-application-method: 1
basket-type: "both"
minimum-basket: 0
lock-to-player: false
storage:
# yaml or mysql
type: "yaml"
mysql:
host: "localhost"
port: 3306
database: "hypercreditsplus"
username: "root"
password: "password"
table: "hypercreditsplus_balances"
logging:
transactions: true
A coupon voucher with a percentage or a package restriction does not fit a plain balance. Set integration.coupons-vouchers-to-balance: false to keep those as normal HyperCredits coupon codes while gift cards still go to Credits.
#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.
#Updating
- Stop the server and replace the HyperCredits jar with the new one (and the HyperCredits+ jar if you use it). Start the server.
- New
config.ymlkeys are added automatically and your values are kept. Player data indata.ymlandredeemed.ymlis used as is. - If a new version changes
messages.ymlor a menu file, your old copy is saved next to the new one with a date in its name, so you can copy your edits over.
Built-in update checker
On copies downloaded from BuiltByBit, HyperCredits checks for new versions when the server starts and every 24 hours (updater.check-interval-hours). It tells the console and everyone with hypercredits.admin.
With updater.auto-download: true the new jar is downloaded to plugins/update/ and installs on the next restart. Your current jar is first backed up to plugins/HyperCredits/backup/.
HyperCredits+ has its own updater section and reminds admins (hypercreditsplus.admin) to update it whenever HyperCredits has a new version. HyperCredits+ is sold as an Extra, so BuiltByBit may not allow API downloads for it. Automatic download for the add-on is off by default.
Restart the server after changing jars.