How to Create

Create one file per voucher inside plugins/FioVoucher/vouchers/.

Basic flow:

1. copy one of the sample files
2. rename it to your voucher id
3. set voucher.id
4. set the item
5. define the reward commands
6. set redeem rules
7. reload the plugin

Minimal shape:

voucher:
  id: example
  display-name: "Example Voucher"
  enabled: true
  item:
    material: PAPER
    amount: 1
    name: "Example Voucher"
    lore:
      - "Voucher"
  commands:
    claimed:
      enabled: true
      actions:
        - "[MESSAGE] Reward claimed"
  settings:
    trial:
      enabled: false
      duration: "0s"
      allow-pause: false
      allow-stack: false
    redeem:
      max-claim: 1

For source-backed examples, see Example.

External References

Use these references when choosing valid values:

• Voucher item materials: Spigot API: org.bukkit.Material
• Item tooltip flags: Spigot API: org.bukkit.inventory.ItemFlag
• Sounds for [SOUND]: Spigot API: org.bukkit.Sound
• Enchantments for [ITEM] enchantment tokens: Spigot API: org.bukkit.enchantments.Enchantment
• MiniMessage text formatting: PaperMC Docs: MiniMessage format and standard tags
• MiniMessage overview: PaperMC Docs: MiniMessage

Prefer the official Spigot/Paper documentation over copied lists from forums, because enum names and supported tags can change between Minecraft versions.