SkiesVouchers
PluginMIT

SkiesVouchers

A simple Minecraft plugin with redeemable vouchers.

10
Downloads
0
Followers
3 months ago
Updated
📦
1
Versions

📖About 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.