Vouchers
Physical, redeemable items that grant Denarius, tokens, ranks, or keys — perfect for trading and gifting.
Vouchers are physical, redeemable items that grant a reward when right-clicked. Staff create them through the VoucherService for fixed Denarius amounts, token grants, ranks, or crate keys, and they can be handed to players as event rewards, compensation for bugs, or seasonal gifts. They are the flexible counterpart to /withdraw banknotes — vouchers are staff-issued for arbitrary reward types, while banknotes are player-minted and currency-only.
How Vouchers Work
A voucher is a regular ItemStack (typically a gold ingot) with a custom display name, lore showing the value, and a PersistentDataContainer tag carrying the voucher type and amount. The data tag is what makes a voucher authoritative — the visual item can be cloned or faked by a resource pack, but the data tag cannot. When you right-click the item:
- The listener fires. A
PlayerInteractEventhandler reads the voucher's data tag. - The reward is granted. The VoucherService routes to the right system — EconomyService for money, the rank manager for ranks, CrateService for keys.
- The item is consumed. One item is removed from your hand, and the reward lands in the relevant balance or inventory.
Because vouchers are physical items, they can be traded, dropped, sold on the Auction House, or stored in your vault — the reward doesn't trigger until someone right-clicks. This makes them perfect for delayed or transferable rewards.
Voucher Types
| Type | Material | Detail |
|---|---|---|
| Denarius Voucher | Gold Ingot | Redeems for a fixed amount of Denarius. The most common voucher type — used for event rewards, compensation, and staff gifts. |
| Token Voucher | Gold Ingot | Redeems for a flat Auctoritas (token) grant. Handed out for tournament prizes and milestone rewards. |
| Rank Voucher | Gold Ingot | Redeems to grant a specific rank — used for donor rank gifts and event grand prizes. |
| Key Voucher | Gold Ingot | Redeems for a crate key of a specific type. A flexible alternative to pre-issuing a key item. |
Vouchers vs. Banknotes
Vouchers and /withdraw banknotes solve similar problems — physical, transferable rewards — but they serve different use cases:
| Aspect | Voucher | Banknote |
|---|---|---|
| Issuer | Staff (admin command) | Any player (via /withdraw) |
| Types | Money, tokens, ranks, keys | Money, tokens, beacons, Aureus |
| Source | Events, compensation, gifts | Player's own balance |
| Anti-dupe | PDC tag + consumption on use | HMAC signature + per-serial burn |
Getting Vouchers
Vouchers are never sold in the shop — they are exclusively issued by staff. Common sources:
- Event rewards. Tournament winners, festival grand prizes, and seasonal event payouts.
- Compensation. When a bug costs a player items or currency, staff may issue a voucher to make them whole.
- Staff gifts. Holiday giveaways and community milestones.
- Tournament chests. Some event loot chests contain vouchers instead of raw currency.
The /voucher command family is admin-facing (for inspecting or issuing vouchers); players simply right-click the item to redeem.
Tips
- Redeem in a safe spot. Right-clicking a voucher consumes it instantly — don't do it in the PVP Mine where you could die mid-click.
- Vouchers are tradable. If you don't want the reward, sell the voucher on the Auction House.
- Store spares in your vault. A voucher in your Player Vault can't be lost on death.
- Check the lore. The value and type are printed in the item's lore before you redeem.
- Report lost vouchers. If a voucher vanishes to a bug, staff can verify the data tag and reissue.