⚙️ Configuration

This page explains how to create and configure voucher items using the voucher file. Vouchers allow you to execute commands when an item is used, with optional conditions, permissions, and PlaceholderAPI support. In game editor can be opened with /voucher edit.


File Purpose

The voucher file is used to define custom items that:

  • Execute console or player commands

  • Support conditional usage

  • Use PlaceholderAPI for dynamic checks

  • Can act as boosters, rewards, or consumables


Condition System

Conditions control whether a voucher can be used.

Supported Operators

Operator
Meaning

&&

AND (both conditions must be true)

`

==

Equals

!=

Not equals

<

Less than

>

Greater than

<=

Less than or equals

>=

Greater than or equals

!

NOT

( )

Force execution order


Execution Order

  1. Each condition is checked

  2. If any condition fails, its failure commands are executed

  3. Voucher usage is cancelled

  4. If all conditions pass, main commands execute


PlaceholderAPI Support

Conditions can use PlaceholderAPI placeholders.

Important Notes

  • Placeholders must return a valid value

  • If a placeholder fails to parse → the condition returns false

  • String comparisons are case-sensitive


Example Condition

✔ Allows usage if:

  • Player has low health and enough food OR

  • Player is not flying


Example: Instant Heal Voucher (With Conditions)


Example: Personal Money Booster Voucher

This voucher activates a personal money booster for the player.


Item Section Explained

Key
Description

Display Name

Item name (supports color codes)

Material

Bukkit material name

Lore

Item description

Enchantments

Adds enchant glow

Flags

Hides enchantments or attributes

Last updated