Introduction

What is ProVouchers?

ProVouchers turns rewards into items players can hold and codes players can type. A voucher is a configurable item (right-click to redeem). A code is a word players enter with /voucher redeem. Both run the same rewards, gate behind the same conditions, and are defined in plain YAML files you can copy, paste, and reload without restarting.

It aims to be approachable to configure and dependable in production:

• Indexed, persistent storage (SQLite, MySQL, MariaDB, or PostgreSQL) instead of a flat file rescanned on every redeem.
• Anti-dupe that survives restarts, with a per-item stamp checked off-thread.
• Loud validation: a typo in a voucher file is reported by /voucher reload with the file and the reason, never silently ignored.
• A typed reward and condition system that reads cleanly for beginners and composes for advanced setups.
• Folia-safe throughout, on Paper or Folia 26.1+.

ProVouchers builds on the Strata shared library for scheduling, storage, text rendering, conditions, integrations, GUIs, and metrics, so the plugin stays focused on vouchers.

Requirements

• Paper or Folia 26.1+ (Java 25)
• Strata 0.10.0+ installed on the server

At a glance

id: example
display-name: "<gradient:#FFD700:#8B0000>Example Voucher</gradient>"
item:
  material: PAPER
  glow: true
lore:
  - "<gray>Right-click to redeem"
cooldown: 0
conditions:
  - type: permission
    permission: "provouchers.use.example"
rewards:
  - "item: DIAMOND 1"
  - "currency: give 250"
  - "message: <green>You redeemed the example voucher!"

Where to go next

• New here? Start with Getting Started.
• Want the mental model? Read Core Concepts.
• Looking for a specific field? Jump to the Voucher Reference, Conditions, or Rewards.
• Something not working? See the FAQ and Troubleshooting.