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)

```yaml 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.