SkiesVouchers

SkiesVouchers

Give players customizable voucher items that run commands when right-clicked. Supports per-player cooldowns, max uses, glowing items, colored names/lore, and placeholder variables in commands.

Features

• Voucher items: configurable material, name, lore, and optional glow.
• Right-click redemption: executes your command list, then consumes one item.
• Per-player limits: optional cooldown (seconds) and max uses.
• Placeholders: [player], [uuid], [world], [x], [y], [z].
• Admin tools: /voucher give, /voucher reload, /voucher list, tab completion included.
• Persistent data: tracks usage and cooldowns in playerdata.yml.

Commands

• /voucher redeem <id> — Give yourself the voucher item.
• /voucher give <player> <id> — Give a voucher item to a player.
• /voucher list — List loaded vouchers.
• /voucher reload — Reload config and player data.

Permissions

• skiesvouchers.redeem (default: op)
• skiesvouchers.list (default: true)
• skiesvouchers.give (default: op)
• skiesvouchers.reload (default: op)

Configuration (excerpt)

vouchers:
  diamond_reward:
    name: "Diamond Reward"
    id: "diamond_reward"
    commands:
      - "give [player] diamond 10"
      - "tellraw [player] {\"text\":\"You received 10 diamonds!\",\"color\":\"aqua\"}"
    cooldown: 0          # seconds, 0 = none
    max-uses: 0          # per-player limit, 0 = unlimited
    item:
      material: PAPER
      name: "&bDiamond Voucher"
      lore:
        - "&7Right-click to claim 10 diamonds"
        - "&fVoucher ID: &eDIAMOND"
      glow: true

Installation

1. Drop skiesvouchers-1.0.jar into your server's plugins/ folder.
2. Start/restart the server to generate config.
3. Edit config.yml to define your vouchers.
4. /voucher reload to apply changes.

Requirements

• Spigot/Paper 1.15+ (tested on 1.21)
• Java 8+

Notes

• Vouchers are redeemed by right-clicking the item in hand.
• If a player's inventory is full when receiving, the item is dropped at their feet.