ProVouchers

<div align="center"> <img src="https://raw.githubusercontent.com/alazso/provouchers/main/.github/assets/banner.png" alt="ProVouchers: a powerful ecosystem of integrations for your server" width="720"> (https://img.shields.io/github/actions/workflow/status/alazso/provouchers/ci.yml?branch=main&style=for-the-badge&label=build)](https://github.com/alazso/provouchers/actions) (https://img.shields.io/endpoint?url=https%3A%2F%2Ffaststats.dev%2Fapi%2Fshields%2Fprovouchers%3Fmetric%3Ddownloads&style=for-the-badge)](https://faststats.dev/project/provouchers) (https://img.shields.io/badge/Paper%20·%20Folia%20·%20Purpur-26.1%2B-2b2d31?style=for-the-badge)](https://papermc.io/) (https://img.shields.io/badge/license-MIT-2b2d31?style=for-the-badge)](https://github.com/alazso/provouchers/blob/main/LICENSE) (https://img.shields.io/badge/Documentation-FF8A00?style=for-the-badge&logo=readthedocs&logoColor=white)](https://alaz.so/provouchers/docs) (https://img.shields.io/badge/Source-0f0f0f?style=for-the-badge&logo=github&logoColor=white)](https://github.com/alazso/provouchers) (https://img.shields.io/discord/1510890328943628350?style=for-the-badge&logo=discord&logoColor=white&label=discord&color=5865F2)](https://discord.gg/m3AKQfrMS5) </div> <br> Create vouchers and redeemable codes backed by a **powerful ecosystem of integrations**, built to help your server stand out. Hand out rewards as **items players right-click** or **codes players type**, define everything in plain YAML, and reload it live, with persistent anti-dupe and cooldowns that survive restarts. <br> ## At a glance | | | |---|---| | 🌍 **Per-player localization** | Every player sees messages in their own Minecraft client language. Ships in **7 languages**. | | 🔒 **Soulbound vouchers** | Cannot be dropped, stored, or traded (each toggle configurable), with optional bind-on-pickup. | | 🎁 **Vouchers and codes** | One reward system, two ways to deliver it. | | 🧩 **Typed rewards** | Items, currency, XP, ranks, permissions, commands, titles, sounds, and weighted random sets. | | 🧱 **Layered conditions** | Gate redemptions on playtime, rank, region, economy, advancements, PlaceholderAPI, and more. | | 🛡️ **Anti-dupe that holds** | Per-item stamps in persistent storage. Clones are rejected; creative, crafting, and item frames are blocked. | | ⏳ **Persistent limits** | Cooldowns and usage caps survive restarts and apply network-wide on a shared database. | | 🔌 **Drop-in integrations** | ItemsAdder, Oraxen, Nexo, Head Database, Vault, LuckPerms, PlaceholderAPI, MiniPlaceholders, WorldGuard. | <br> ## Every feature **Delivery and rewards** - **Vouchers** (physical items players right-click) and **codes** (typed with `/voucher redeem`). - Reward types: **items, currency, XP, ranks, permissions, console/player commands, broadcasts, titles, action bars, sounds, Discord webhooks**. - **Weighted random reward sets**, on top of always-run rewards. - **Named random rolls** (`%random:1-100:loot%`): give a roll and announce the exact same number. - **Decorated reward items**: define an item once (name, lore, glow, custom/head) and grant it by reference. - **Discord webhooks**: post a message or a rich embed to a per-voucher webhook on redeem; drop it in a random set to announce only the rare hits. - **Shift + right-click to mass-open** a whole stack at once. **The Stash** (virtual, itemless vouchers) - Players claim queued rewards from a **`/stash` menu**; each claim runs the voucher through the normal pipeline (its conditions and effects), with a **Claim all** button. - **`/voucher stashgive`** and the developer API deliver vouchers to **offline players**. - **Overflow safety net**: a reward that does not fit a player's inventory queues in the Stash instead of dropping on the ground. - Optional **auto-expiry** with a live countdown on each entry. **Conditions** (all must pass before a redeem) - permission, rank (LuckPerms), world, region (WorldGuard), gamemode, economy balance (Vault), experience level, **playtime**, **item in inventory**, **advancement completed**, **PlaceholderAPI comparison**, player statistic. **Limits and lifecycle** - **Global usage limits** per voucher or code (the first N redemptions server-wide). - **Per-player usage limits** (each player may redeem it N times, ever). - **Per-player cooldowns** that survive restarts, with **permission-based tiers** so VIPs wait less. - **Expiry**: a fixed date (`2026-07-01`), a date-time, or relative (`30d` from when it was given). - **Active-from**: not redeemable until a chosen date. **Security and control** - **Soulbound**: block dropping, storing, and trading independently; optionally bind to whoever picks it up. - **Owner-only** vouchers: only the player it was given to may redeem it. - **Two-step confirmation**: require a second click, as a chat prompt or a GUI dialog. - Blocked in creative an