Voucher Configuration Wiki

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.

---

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

(%player_health% < 20 && %player_food% > 10) || !%player_is_flying%

✔ Allows usage if:

• Player has low health and enough food OR

• Player is not flying

---

Example: Instant Heal Voucher (With Conditions)

instant_heal:
  Conditions:
    check_health:
      Condition: "%player_health% < 20"
      Console Commands:
        - "[MESSAGE] §cYou are already at max health!"

    check_gamemode:
      Condition: "%player_gamemode% == SURVIVAL"
      Console Commands:
        - "[MESSAGE] §cYou can only use this item in survival mode!"

    check_permission:
      Condition: "%luckperms_check_permission_vortexprisoncore.vouchers.item.instant_health% == yes || %luckperms_check_permission_vortexprisoncore.vouchers.all%"
      Console Commands:
        - "[MESSAGE_KEY:General.No Permission]"

  Console Commands:
    - "heal <player>"
    - "[MESSAGE] §aYou feel refreshed!"

  Item:
    Display Name: "§6§lInstant Heal"
    Material: "GOLDEN_APPLE"
    Enchantments:
      MENDING: 1
    Flags:
      - "HIDE_ENCHANTS"
    Lore:
      - "§7Heals you to max health."

---

Example: Personal Money Booster Voucher

This voucher activates a personal money booster for the player.

personal_money_booster:
  Item:
    Display Name: "§6§lPersonal Money Booster"
    Material: "EMERALD"
    Lore:
      - "§7Boosts your money gain by 50% for 1 hour."
    Enchantments:
      MENDING: 1
    Flags:
      - "HIDE_ENCHANTS"

  Console Commands:
    - "booster activate economy_money_booster <player> 1h"

---

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