CommandsAPI
VZone Plugins/VVoucher/Overview

VVOUCHER

Overview

VVoucher is a configurable Minecraft voucher plugin for Spigot and Paper style servers. It is built around config-created voucher items that players can receive, keep, and use in game.

What It Is

Each voucher is an item definition loaded from YAML. A voucher can run console commands, support multiple uses, use random values, show chat or title feedback, and apply extra item metadata such as glow, enchantments, attributes, flags, or potion effects.

The plugin is designed so server owners can build reward systems without writing custom code for every item. If you need code-level access, the API is available for other plugins too.

Why It Is Easy To Understand

Config-first setup

  • Voucher definitions are loaded from /plugins/VVoucher/vouchers/*.yml.
  • Text messages live in separate language files under /plugins/VVoucher/lang/.
  • The active language and prefix are controlled by config.yml.

Reliable item detection

  • Voucher items are identified with persistent data, not by display name or lore.
  • The internal marker format is vvouchers:%config-key%.
  • This means renamed items can still be recognized correctly.

Compatibility

  • Supports Minecraft server versions from 1.16.x up to 1.21.x.
  • Works on Spigot and Paper style servers.
  • Build system: Maven.
  • Main package: hu.vzone.vvoucher.
  • Main class: hu.vzone.vvoucher.VVoucherPlugin.

File Layout

plugins/VVoucher/
|- config.yml
|- lang/
|  |- en.yml
|  `- hu.yml
`- vouchers/
   `- example.yml
The exact default files are available under the Configurations section, so the user can read both the explanation and the raw file content.
PreviousWelcomeNextFeatures