VZone Plugins/VVoucher/Overview

VVOUCHER

Overview

VVoucher lets you create usable reward items. A player receives a voucher item, clicks it, and the plugin runs the configured command, random reward, reusable event, and messages.

Start Here

  • Create or edit a voucher file under vouchers/.
  • Reload with /vvoucher reload.
  • Give yourself the voucher with /vvoucher give <voucher-name>.
  • Test the item click action before giving it to players.

What It Is

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

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.
  • Reusable event reward tables are loaded from /plugins/VVoucher/events/*.yml.
  • Text messages live in separate language files under /plugins/VVoucher/lang/.
  • The active language, prefix, and update notifier 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.
  • Built-in version checker can notify console and players with vvoucher.update-notify.
  • Build system: Maven.
  • Main package: hu.vzone.vvoucher.
  • Main class: hu.vzone.vvoucher.VVoucherPlugin.

File Layout

plugins/VVoucher/
|- config.yml
|- plugin.yml
|- events/
|  `- example.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