FelVouchers

FelVouchers

Create fully configurable command vouchers with custom rewards, requirements, recipes, and integrations.

FelVouchers lets administrators define stackable vouchers in individual, easy-to-understand YAML files. Players hold a voucher in their main hand and right-click to redeem one, or crouch and right-click to redeem the stack.

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

Features

• Unlimited voucher definitions using one YAML file per voucher
• Custom materials, names, lore, glow, enchantments, item flags, rarity, models, player heads, and supported custom-item providers
• Unlimited ordered [console] and [player] commands
• ALL, INDEPENDENT_CHANCE, and WEIGHTED reward-selection modes
• Single-item and crouched stack redemption
• Configurable confirmation menu enabled by default
• Permission, world, WorldGuard region, Vault balance or cost, cooldown, total-use, owner, and expiration requirements
• Configurable messages, announcements, sounds, particles, titles, and action bars
• Built-in placeholders and optional PlaceholderAPI processing
• Persistent item identity that ordinary item renaming cannot reproduce
• Persistent claim queue for full inventories
• Optional shaped and shapeless recipes
• Human-readable file auditing, SQLite auditing, or both
• Validation, inspection, reload, and integration-status commands

Default behaviour

• Vouchers redeem from the player's main hand.
• A normal use consumes one item.
• Crouching redeems the held stack, subject to the configurable safety limit.
• The confirmation menu is enabled.
• Full inventories send issued vouchers to a persistent claim queue.
• Recipes, SQLite logging, and the update checker remain disabled until configured.

Reward modes

• ALL: Execute every enabled reward in configuration order.
• INDEPENDENT_CHANCE: Roll each enabled reward using its own percentage.
• WEIGHTED: Perform a configurable number of relative-weight selections, with optional duplicates.

Requirements

• Paper 26.2
• Java 25 or newer
• Internet access on first startup so Paper can obtain the declared SQLite library

FelVouchers has no required plugin dependencies.

Installation

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

Do not use /reload. Use /fv reload after changing configuration, or restart the server when changing the logging mode.

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.

Permissions

felvouchers.admin
felvouchers.command.give
felvouchers.command.giveall
felvouchers.command.claim
felvouchers.command.list
felvouchers.command.inspect
felvouchers.command.validate
felvouchers.command.reload
felvouchers.command.debug
felvouchers.redeem
felvouchers.confirmation.bypass
felvouchers.announcements.receive

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

Missing optional integrations do not prevent FelVouchers from starting.

Support

For configuration help, bug reports, and suggestions, join the Felidari Plugin Support Discord.

When reporting an issue, include your FelVouchers version, Paper build, Java version, relevant logs, affected voucher file, /fv validate output, and /fv debug output.

License

FelVouchers is free, closed-source software distributed under the FelVouchers Freeware License. Redistribution, resale, rehosting, sublicensing, and distribution of modified copies are not permitted.

FelVouchers is an independent project and is not affiliated with or endorsed by Mojang Studios, Microsoft, or PaperMC.