CommandsAPI
VZone Plugins/VVoucher/Features

VVOUCHER

Features

This page focuses on what the plugin can do in practice, not just what files it has. The goal is to help the user quickly understand the plugin's real strengths.

Core Plugin Features

  • Voucher definitions loaded from /plugins/VVoucher/vouchers/*.yml.
  • Language system with separate files in /plugins/VVoucher/lang/.
  • Configurable message prefix.
  • Clear configuration warnings in console for invalid voucher data.
  • Public API for other plugins to read voucher data.

Reward System

  • Standard command rewards with Command.
  • Weighted reward support with Random-Command.
  • Voucher-level random values with %random-amount%.
  • Reward-level local random values with %local-random%.
  • Support for multiple uses with Usage.

Item Customization

  • Supports normal Bukkit materials as voucher items.
  • Supports HeadDatabase heads with Material: HDB-<id>.
  • Supports custom base64 textures for PLAYER_HEAD.
  • Supports item flags, enchantments, glow, attributes, custom model data, and potion effects.
  • Supports formatted names and lore for each voucher item.

Text and Placeholder Support

  • Supports MiniMessage, hex colors, and legacy & formatting.
  • PlaceholderAPI placeholders can be used in names, lore, messages, and commands.
  • Voucher use messages are available through Message-Chat, Message-Title, and Message-ActionBar.
  • The same message formats are supported inside random reward entries too.
<gradient:#1378FF:#60BFFB>VVoucher</gradient>
&#1378FFV&#1D81FFV&#268AFEO
&8&l| &fUsage: &#60BFFB%current-usage%&8/&#60BFFB%max-usage%

Important Behavior

Voucher items have their normal vanilla use blocked. A voucher made from a block cannot be placed, and a voucher made from items like ender pearls, fireworks, food, or potion-like materials cannot be used normally. They only work through the configured voucher action.
PreviousOverviewNextCommands