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.