RedeemCodes – Easy & Powerful Code Redemption Plugin for Minecraft

RedeemCodes is a lightweight yet powerful plugin that allows server administrators to create, manage, and redeem custom codes to reward players.

---

## 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 or global redemption limits with cooldown timers.

* Interactive GUI Editor – Manage codes and rewards directly in an intuitive in-game GUI.

* Success & Error Sounds – Configurable sounds that play on successful or failed redemption.

* Placeholder Support – Use placeholders like %player%, %uuid%, %random-min-max%, and more inside reward commands.

* Permission-Based Access – All admin commands are fully permission protected.

* Fully Configurable – Customize all messages, sounds, and prefix in config.yml.

---

## Reward System

* Console Command: Rewards are assigned as console commands, creating endless possibilities without limitations.

* Placeholder Support: Supports placeholders to add custom values in commands.

---

## Supported 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:

yaml <br> - "eco give %player% %random-100-500%" <br>

---

## Commands & Permissions

### ✅ Player Command

plaintext <br> /redeem &lt;code&gt; <br>

Redeem a code and claim its reward.

⤷ Permission: None (available to all players)

---

### Admin Commands

plaintext <br> /rc create &lt;code&gt; - Create a new code <br> /rc remove &lt;code&gt; - Remove a code <br> /rc addreward &lt;code&gt; &lt;command&gt; - Add a reward command to a code <br> /rc removereward &lt;code&gt; &lt;id&gt; - Remove a reward by ID <br> /rc list - List all codes <br> /rc redeemed &lt;code&gt; - Show players who redeemed a code <br> /rc rewards &lt;code&gt; - Show rewards attached to a code <br> /rc reload - Reload plugin configs <br> /rc version - View plugin version <br>

⤷ Permission: op

---

## ️ GUI System

The plugin includes a modern and easy-to-use GUI for code management:

* Main Menu

* Create Code

* Codes List

* Admin Command




* Codes List GUI

* View all available codes at a glance




* Code Editor

* Edit rewards, settings, and options directly in-game




---

## Example Code Setup

<details>

<summary>codes.yml</summary>

yaml <br> Codes: <br> samplecode: <br> enabled: true <br> permisson: <br> required: false <br> list: <br> - code.sample.redeem <br> <br> redeem-limit: <br> Type: PLAYER <br> Count: 1 <br> Cooldown: 5 <br> Cooldown-message: "&amp;cYou must wait %Cooldown% before redeeming again!" <br> Playerlist: <br> Used: [] <br> Blacklist: <br> Type: ENABLED <br> List: <br> - reyalp <br> rewards: <br> - say %player% redeemed with UUID %uuid% <br> - give %player% diamond %random-1-5% <br>

</details>

---

## Configurable Sounds

yaml <br> sounds: <br> success: ENTITY_PLAYER_LEVELUP <br> failure: BLOCK_ANVIL_LAND <br>

---

## Fully Customizable Messages

yaml <br> messages: <br> redeem-success: "&amp;aSuccessfully redeemed the code!" <br> already-used: "&amp;eYou have already redeemed this code." <br> blacklisted: "&amp;cYou are not allowed to redeem this code." <br> code-disabled: "&amp;cThis code is currently disabled." <br> out-of-stock: "&amp;cThis code is out of stock!" <br>

---

## Requirements

* Minecraft 1.20.2+

* Paper / Spigot / Purpur / Bukkit

---

## Why Use RedeemCodes?

Whether you’re organizing events, giveaways, loyalty programs, or simple player rewards, RedeemCodes offers a seamless, lightweight, and customizable way to engage your server community.