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.
  • Reusable event reward tables loaded from /plugins/VVoucher/events/*.yml.
  • Language system with separate files in /plugins/VVoucher/lang/.
  • Configurable message prefix.
  • Built-in version checker using your Maven metadata URL.
  • Per-command permissions for every subcommand.
  • 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.
  • Event support inside Random-Command for reusable reward tables.
  • Voucher-level random values with %random-amount%.
  • Reward-level local random values with %local-random%.
  • Support for multiple uses with Usage.
  • Manual reusable event execution with /vvoucher run-event.

Item Customization

  • Supports normal Bukkit materials as voucher items.
  • Supports HeadDatabase heads with Material: HDB-<id>.
  • Supports custom base64 textures for PLAYER_HEAD.
  • Supports optional TooltipStyle values on Minecraft 1.21.2+ using a valid namespace:path resource location.
  • Supports item flags, enchantments, glow, attributes, custom model data, and potion effects.
  • Supports per-item MaxStackSize when the running server version allows it.
  • 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