voucherManager.png
VoucherEditor.png
voucherItem.png
Description
HTVouchers
Discord : https://discord.gg/y6RemcjSaD
A voucher/crate key system for Hytale servers. Create custom redeemable items with weighted random rewards, sound/particle effects, and a full in-game UI editor. Vouchers are cloned from existing game items and given custom interactions, names, descriptions, and loot tables — all configurable without restarting the server.
Commands
| Command | Usage | Description |
|---|---|---|
/voucher give |
/voucher give <player> <voucher> [amount] |
Give voucher items to a player |
/voucher list |
/voucher list |
List all configured vouchers |
/voucher info |
/voucher info <voucher> |
Show voucher details and reward probabilities |
/voucher preview |
/voucher preview <voucher> |
Show reward table with percentage bars |
/voucher reload |
/voucher reload |
Reload config from disk and re-register items |
/voucher ui |
/voucher ui |
Open the in-game voucher editor GUI |
Alias: /v (e.g. /v give Player1 htvouchers:common_crate 3)
Permissions
| Permission | Description |
|---|---|
htvouchers.admin |
Base permission for all admin commands |
htvouchers.admin.give |
Give vouchers to players |
htvouchers.admin.list |
List all configured vouchers |
htvouchers.admin.info |
View voucher details |
htvouchers.admin.preview |
Preview reward tables |
htvouchers.admin.reload |
Reload voucher config |
htvouchers.admin.ui |
Open the voucher editor UI |
Features
- Custom Items — Clones any base game item with custom ID, display name, description, quality/rarity, and stack size
- Weighted Rewards — Each voucher has a loot table with weighted random selection; supports multiple rolls per use
- Command Rewards — Rewards execute server commands (or player commands with
player:prefix) with{player}placeholder - Effects — Configurable sound and particle effects on redeem
- Cooldowns — Per-voucher cooldown between uses
- Broadcast Messages — Optional server-wide announcement on redeem with
{player},{voucher},{reward}placeholders - In-Game UI Editor — Full GUI for creating/editing/deleting vouchers, managing rewards, giving items to players or all online players
- Rich Descriptions — Multi-line item descriptions with
<color is="#hex">text</color>support - Hot Reload — Config changes apply immediately without server restart
Configuration
Vouchers are stored in vouchers.json and auto-generated with examples on first run. All changes via the UI editor are saved automatically.
The HTVouchers Team
