FelVouchers

FelVouchers lets server administrators create stackable vouchers through easy-to-understand YAML files. Players simply hold a voucher in their main hand and right-click to redeem it, or crouch and right-click to redeem an entire stack.

Every included configuration file contains detailed comments explaining the available values, modes, placeholders, units, and interactions between settings.

Features

• Unlimited YAML vouchers: Define each voucher in its own configuration file.
• Completely custom items: Configure material, display name, lore, glow, enchantments, flags, rarity, models, player heads, and supported custom-item providers.
• Ordered command rewards: Run any number of [console] or [player] commands in the exact order you choose.
• Flexible reward selection: Use all rewards, independent percentage chances, or weighted selections with configurable roll counts.
• Stack redemption: Right-click to redeem one voucher or crouch while right-clicking to redeem the stack, subject to the configurable safety limit.
• Confirmation menu: An optional confirmation GUI helps prevent accidental redemptions and is enabled by default.
• Powerful requirements: Restrict vouchers by permission, world, WorldGuard region, Vault balance or cost, cooldown, total uses, ownership, and expiration.
• Custom feedback: Configure messages, broadcasts, sounds, particles, titles, and action bars.
• Placeholder support: Includes built-in placeholders and optional PlaceholderAPI processing.
• Safe item identity: Voucher IDs are stored using persistent item data, so renaming an ordinary item does not turn it into a voucher.
• Inventory protection: Full-inventory deliveries can be persistently queued and claimed later.
• Optional crafting: Create shaped or shapeless recipes with vanilla or supported custom items; recipes are disabled by default.
• Auditing: Record redemptions in readable daily log files, SQLite, or both.
• Helpful administration: Validate definitions, inspect held vouchers, reload configuration, and view integration status in-game.

Default behaviour

• Vouchers are redeemed from the player's main hand.
• One item is consumed per normal use.
• Crouching redeems the held stack.
• The confirmation menu is enabled.
• Full inventories place issued vouchers into a persistent claim queue.
• Crafting recipes, SQLite logging, and the update checker are disabled until configured.

Reward modes

• ALL: Executes every enabled reward in its configured order.
• INDEPENDENT_CHANCE: Rolls every enabled reward using its own percentage chance.
• WEIGHTED: Selects a configurable number of rewards using relative weights, with optional duplicate selections.

Commands

• /felvouchers help
• /felvouchers give <player> <voucher> [amount]
• /felvouchers giveall <voucher> [amount]
• /felvouchers claim
• /felvouchers list
• /felvouchers inspect
• /felvouchers validate [voucher]
• /felvouchers reload
• /felvouchers debug

The shorter /fv alias works for every command.

Optional integrations

• PlaceholderAPI - Additional placeholders in voucher text, commands, and effects.
• Vault - Minimum-balance requirements and redemption costs.
• WorldGuard - Allowed and blocked redemption regions.
• ItemsAdder, Oraxen, and Nexo - Custom voucher icons and recipe ingredients.

FelVouchers has no required plugin dependencies. Missing optional integrations do not prevent it from starting.

Installation

1. Stop your Paper server.
2. Place FelVouchers.jar inside the plugins folder.
3. Start the server and allow the default files to generate.
4. Run /fv validate and /fv debug.
5. Try the included example with /fv give <player> welcome 1.

Requirements: Paper 26.2 and Java 25 or newer.

Support

Need help, found a bug, or have a suggestion? Join the support server:
Felidari Plugin Support Discord