<div align="center"> <img src="https://cdn.modrinth.com/data/cached_images/2018cfdff840876bfa1c45b362fea47751057238.png" alt="RedeemCodes Minecraft Plugin Banner" /> <h1>RedeemCodes - The Ultimate Minecraft Voucher & Rewards Plugin</h1> <p><b>Create custom redeem codes, vouchers, and rewards for your Minecraft server with infinite possibilities!</b></p> </div> **RedeemCodes** is the most advanced, free **Minecraft Redeem Codes and Vouchers plugin** available for Spigot, Paper, and Folia servers. Whether you are running a survival SMP, Skyblock, or Factions server, RedeemCodes allows server administrators to easily create, manage, and distribute custom codes to reward their players. From simple item drops to complex gacha-style reward pools, RedeemCodes provides everything you need to boost player engagement through giveaways, vote rewards, and VIP perks. ### 🌟 Key Features * **Custom Redeemable Codes** – Define unlimited codes with flexible reward options. * **Blacklist/Whitelist System** – Block or allow specific players for each code. * **Redemption Limits & Cooldowns** – Set per-player, per-IP, or global redemption limits with cooldown timers. * **Permission System** - Develop permission-based codes to limit usage to a specific rank or group * **Events** - Trigger customizable actions such as fireworks, command sets, or animations when a reward is claimed * **Interactive GUI Editor** – Manage codes and rewards directly in an intuitive in-game GUI. * **Interaction Sounds** – Configurable sounds that play on events, successful or failed redemption. * **Permission-Based Access** – Every admin command is fully protected by permissions. * **Fully Configurable** – Customize all messages, sounds, and prefix in `config.yml`. * **File Tracker** - Monitors all plugin files and notifies admins about invalid formats, syntax issues, and errors * **Async Data Management** - Reads and writes data asynchronously to ensure smooth, lag-free file management * **Infinite Rewards** - Create command-based rewards that execute console commands, or design custom rewards with our various reward types, unlocking infinite possibilities. ### Reward System Build anything from simple rewards to complex gacha-style reward pools by combining multiple reward types. * **Multiple Distribution Modes** – Choose how rewards are given: * **ALL** – Grant every configured reward. * **RANDOM** – Select one reward pack randomly. * **DRAW** – Select one reward using configurable weighted chances. * **Command Packs** – Group multiple console commands into reusable reward packs. * **Sacks** – Give predefined item collections directly to the player's inventory. * **Premade Rewards** – Reuse commonly used reward sets defined in `premades.yml`. * **Reward Events** – Trigger custom celebrations, animations, sounds, fireworks, or other effects from the `events` folder. * **Weighted Rewards** – Assign weights to reward packs for loot box or gacha-style reward systems. * **Mix & Match Categories** – Combine commands, sacks, premades, and events in a single reward for highly customizable redemption experiences. * **Placeholder Support** – Supports PlaceholderAPI and built-in placeholders. ### Built-in Placeholders * `%player%` – Player's name * `%uuid%` – Player's UUID * `%displayname%` – Player's display name * `%world%` – World name * `%random-min-max%` – Random number within a range Example reward configuration: ```yaml rewards: type: DRAW events: - celebration commands: lucky_cash: - "eco give %player% %random-500-1000%" - "msg %player% &aYou won a cash reward!" - "weight: 10" sacks: - starter: 5 - miner: 2 premades: - vip_rank: 1 ``` ### Commands & Permissions **Player Command** ```plaintext /redeem <code> ``` Redeem a code and claim its reward. ⤷ *Permission: None (available to all players)* **Admin Commands** | Command | Description | | :--- | :--- | | `/rc create <code>` | Create a new code and initialize settings. | | `/rc remove <code>` | Delete a code completely. | | `/rc list` | List all existing codes with their active status. | | `/rc show <code>` | Show details and configured rewards of a code. | | `/rc redeemed <code> `| View a paginated list of players who redeemed a code. | | `/rc reward` | Add, remove, or view code rewards. | | `/rc sack` | Add, remove, edit, or give Sack integrations. | | `/rc premade` | Add, remove, or view Premade reward sets. | | `/rc event` | Add, remove, or test Event hooks. | | `/rc gui` | Open the interactive RedeemCodes Admin Menu. | | `/rc reload` | Reload the configuration safely. | | `/rc version` | View the active plugin version. | | `/rc test <code>` | Dry run a code to safely test its rewards. | | `/rc info` | View detailed plugin information and credits. | | `/rc help ` | Show the help menu. | | `/rc review <message>` | Send a review or bug report to the developers. | *Note: All admin commands support seaml

RedeemCodes - The Ultimate Minecraft Voucher & Rewards Plugin

Create custom redeem codes, vouchers, and rewards for your Minecraft server with infinite possibilities!

RedeemCodes is the most advanced, free Minecraft Redeem Codes and Vouchers plugin available for Spigot, Paper, and Folia servers. Whether you are running a survival SMP, Skyblock, or Factions server, RedeemCodes allows server administrators to easily create, manage, and distribute custom codes to reward their players.

From simple item drops to complex gacha-style reward pools, RedeemCodes provides everything you need to boost player engagement through giveaways, vote rewards, and VIP perks.

### 🌟 Key Features

Custom Redeemable Codes – Define unlimited codes with flexible reward options. Blacklist/Whitelist System – Block or allow specific players for each code. Redemption Limits & Cooldowns – Set per-player, per-IP, or global redemption limits with cooldown timers. Permission System - Develop permission-based codes to limit usage to a specific rank or group Events - Trigger customizable actions such as fireworks, command sets, or animations when a reward is claimed Interactive GUI Editor – Manage codes and rewards directly in an intuitive in-game GUI. Interaction Sounds – Configurable sounds that play on events, successful or failed redemption. Permission-Based Access – Every admin command is fully protected by permissions. Fully Configurable – Customize all messages, sounds, and prefix in `config.yml`. File Tracker - Monitors all plugin files and notifies admins about invalid formats, syntax issues, and errors Async Data Management - Reads and writes data asynchronously to ensure smooth, lag-free file management Infinite Rewards - Create command-based rewards that execute console commands, or design custom rewards with our various reward types, unlocking infinite possibilities.

### Reward System

Build anything from simple rewards to complex gacha-style reward pools by combining multiple reward types.

Multiple Distribution Modes – Choose how rewards are given: ALL – Grant every configured reward. RANDOM – Select one reward pack randomly. DRAW – Select one reward using configurable weighted chances. Command Packs – Group multiple console commands into reusable reward packs. Sacks – Give predefined item collections directly to the player's inventory. Premade Rewards – Reuse commonly used reward sets defined in `premades.yml`. Reward Events – Trigger custom celebrations, animations, sounds, fireworks, or other effects from the `events` folder. Weighted Rewards – Assign weights to reward packs for loot box or gacha-style reward systems. Mix & Match Categories – Combine commands, sacks, premades, and events in a single reward for highly customizable redemption experiences. Placeholder Support – Supports PlaceholderAPI and built-in placeholders.

### Built-in Placeholders

`%player%` – Player's name `%uuid%` – Player's UUID `%displayname%` – Player's display name `%world%` – World name `%random-min-max%` – Random number within a range

Example reward configuration:

```yaml rewards: type: DRAW

events: - celebration

commands: lucky_cash: - "eco give %player% %random-500-1000%" - "msg %player% &aYou won a cash reward!" - "weight: 10"

sacks: - starter: 5 - miner: 2

premades: - vip_rank: 1 ```

### Commands & Permissions

Player Command

```plaintext /redeem ```

Redeem a code and claim its reward. ⤷ Permission: None (available to all players)

Admin Commands

| Command | Description | | :--- | :--- | | `/rc create ` | Create a new code and initialize settings. | | `/rc remove ` | Delete a code completely. | | `/rc list` | List all existing codes with their active status. | | `/rc show ` | Show details and configured rewards of a code. | | `/rc redeemed `| View a paginated list of players who redeemed a code. | | `/rc reward` | Add, remove, or view code rewards. | | `/rc sack` | Add, remove, edit, or give Sack integrations. | | `/rc premade` | Add, remove, or view Premade reward sets. | | `/rc event` | Add, remove, or test Event hooks. | | `/rc gui` | Open the interactive RedeemCodes Admin Menu. | | `/rc reload` | Reload the configuration safely. | | `/rc version` | View the active plugin version. | | `/rc test ` | Dry run a code to safely test its rewards. | | `/rc info` | View detailed plugin information and credits. | | `/rc help ` | Show the help menu. | | `/rc review ` | Send a review or bug report to the developers. |

*Note: All admin commands support seaml