Voucher YAML List

Bundled voucher files are located in:

plugins/FioVoucher/vouchers/*.yml

Each file uses voucher.id as the voucher code. This code is used in commands such as /voucher redeem <code>, /voucher admin give <player> <voucherid> [amount], /voucher info <code>, and /voucher admin freeze <voucherid>.

Quick usage

/voucher list
/voucher info money
/voucher redeem money
/voucher admin give Steve money 1
/voucher admin giveall trial_vip 1
/voucher admin freeze behavior_glow_unbreakable
/voucher admin unfreeze behavior_glow_unbreakable

tip

When creating a new voucher, copy one of the YAML files in the vouchers folder, rename the file, then update voucher.id. Commands use voucher.id, not the file name.

Bundled vouchers

YAML File	Voucher ID	Material	Usage
example.yml	example	PLAYER_HEAD	Full template covering armor trims, command actions, toast, title, item rewards, experience, bundles, enchantments, durability, unbreakable items, and permission gates. Use it as a starting point for new voucher files.
money.yml	money	PAPER	Simple economy voucher. It gives money through a [CONSOLE] action, typically connected to an economy plugin command.
permission_kit.yml	permission_kit	CHEST	Permission-gated starter kit example. Use it for rewards that require the player to have, or not have, a specific permission.
random_food.yml	random_food	COOKED_BEEF	Random food reward example. It uses commands.random-claimed to select one reward branch by chance.
trial_vip.yml	trial_vip	PLAYER_HEAD	VIP trial voucher example. It grants temporary access through settings.trial, including trial duration and optional pause/stack behavior.
world_crate.yml	world_crate	TRIPWIRE_HOOK	World-restricted crate voucher example. Use it for rewards that should only be claimable in specific worlds through settings.redeem.world.
behavior_banner_patterns.yml	behavior_banner_patterns	WHITE_BANNER	Banner pattern item example. Use it to test pattern metadata on banner rewards.
behavior_bundle_container.yml	behavior_bundle_container	BUNDLE	Bundle container example that renders items inside the bundle through bundle_container behavior. The displayed bundle contents are locked as reward presentation data.
behavior_crossbow_model.yml	behavior_crossbow_model	CROSSBOW	Custom model data example for crossbows. Useful for servers with resource-pack item models.
behavior_diamond_trim_chestplate.yml	behavior_diamond_trim_chestplate	DIAMOND_CHESTPLATE	Armor trim example for a diamond chestplate. Use it for modern cosmetic armor rewards.
behavior_glow_unbreakable.yml	behavior_glow_unbreakable	DIAMOND_SWORD	Glow and unbreakable item example. Use it for special rewards that should not lose durability.
behavior_gold_trim_boots.yml	behavior_gold_trim_boots	GOLDEN_BOOTS	Armor trim example for golden boots. Use it as another armor trim reward variant.
behavior_iron_trim_helmet.yml	behavior_iron_trim_helmet	IRON_HELMET	Armor trim example for an iron helmet. Use it to document armor material and trim combinations.
behavior_leather_boots.yml	behavior_leather_boots	LEATHER_BOOTS	Leather boots color example. Useful for custom-colored leather armor rewards.
behavior_leather_chestplate.yml	behavior_leather_chestplate	LEATHER_CHESTPLATE	Leather chestplate color example. Use it as part of a cosmetic leather armor set.
behavior_leather_helmet.yml	behavior_leather_helmet	LEATHER_HELMET	Leather helmet color example. Use it for custom-colored leather armor variants.
behavior_leather_horse_armor.yml	behavior_leather_horse_armor	LEATHER_HORSE_ARMOR	Leather horse armor color example. Useful for cosmetic mount rewards.
behavior_leather_leggings.yml	behavior_leather_leggings	LEATHER_LEGGINGS	Leather leggings color example. Use it to complete a custom leather armor set.
behavior_model_data.yml	behavior_model_data	PAPER	model-data item example. Useful for servers using custom item models from a resource pack.
behavior_netherite_trim_leggings.yml	behavior_netherite_trim_leggings	NETHERITE_LEGGINGS	Armor trim example for netherite leggings. Use it for premium armor rewards.
behavior_potion_regeneration.yml	behavior_potion_regeneration	POTION	Potion metadata example for regeneration. Useful for ready-to-use potion rewards.
behavior_potion_speed.yml	behavior_potion_speed	SPLASH_POTION	Splash potion metadata example for speed. Use it for throwable potion rewards.
behavior_potion_strength.yml	behavior_potion_strength	LINGERING_POTION	Lingering potion metadata example for strength. Use it for lingering potion rewards.
behavior_random_reward.yml	behavior_random_reward	PRISMARINE_SHARD	Random reward behavior example. Use it to understand chance-based reward groups in commands.random-claimed.
behavior_shield_patterns.yml	behavior_shield_patterns	SHIELD	Shield pattern example. Useful for cosmetic shield vouchers.
behavior_tipped_arrow.yml	behavior_tipped_arrow	TIPPED_ARROW	Tipped arrow metadata example. Use it for arrow rewards with potion effects.

Command pattern per voucher

Replace <voucherid> with one of the IDs from the table above:

/voucher redeem <voucherid>
/voucher info <voucherid>
/voucher delete <voucherid>
/voucher pause <voucherid>
/voucher admin give <player> <voucherid> [amount]
/voucher admin giveall <voucherid> [amount]
/voucher admin freeze <voucherid>
/voucher admin unfreeze <voucherid>

/voucher pause <voucherid> only works for trial vouchers with both settings.trial.enabled and settings.trial.allow-pause enabled.