VZone Plugins/VVoucher/Items/Features

VVOUCHER ITEMS

Features

This page explains the complete set of important settings that can be assigned to a voucher item.

Core Visual Settings

  • Material can be a Bukkit material name or HDB-<id>.
  • Name controls the visible item name and supports MiniMessage, hex colors, and legacy formatting.
  • Lore defines multi-line item descriptions with placeholder support.
  • Texture allows a base64 texture when the material is PLAYER_HEAD.
  • TooltipStyle optionally applies a custom tooltip frame style on Minecraft 1.21.2+ using a valid namespace:path resource location such as global:mythic.
  • MaxStackSize optionally overrides how many of that voucher item can stack together.

Behavior Settings

  • Usage sets how many times the item can be used before it disappears.
  • Enable controls whether the voucher is active or disabled.
  • Action defines which player interaction triggers the item.
  • Command runs the fixed console reward command.
  • Random generates the value used by %random-amount%.
  • Random-Command creates a weighted reward list with separate outcomes.
  • Event inside a reward entry can call a reusable external event table from events/*.yml.

Messages and Meta

  • Message-Chat sends a chat message when the voucher is used.
  • Message-Title shows a title and optional subtitle.
  • Message-ActionBar displays action bar feedback.
  • Glow, CustomModelData, and Unbreakable control extra visual item behavior.
  • ItemFlags, Enchantments, Attributes, and Potion extend the item with more metadata.
TooltipStyle is ignored safely on older server versions. If the client resource pack does not provide the referenced tooltip textures, Minecraft shows the missing texture for that style.
PreviousItemsNextExamples