Redeem Codes [⭐Gui]
Best free redeem codes plugin for Minecraft servers
1,23k
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
Redeem Codes [⭐Gui]
🌟 RedeemCodes – Easy & Powerful Code Redemption Plugin for Minecraft
RedeemCodes is a powerful plugin that allows server administrators to create, manage, and redeem custom codes to reward players.
---
🔧 Features
* 🎟️ Fully Configurable – Define unlimited codes with flexible reward options. * ⛔ Fully Configurable – Block or allow specific players for each code. * 🔄 Fully Configurable – Set per-player or global redemption limits with cooldown timers. * 🎨 Fully Configurable – Manage codes and rewards directly in an intuitive in-game GUI. * 🔊 Fully Configurable – Configurable sounds that play on successful or failed redemption. * 🧩 Fully Configurable – Use placeholders like `%player%`, `%uuid%`, `%random-min-max%`, and more inside reward commands. * 🔐 Fully Configurable – All admin commands are fully permission protected. * 🧠 Fully Configurable – Customize all messages, sounds, and prefix in `config.yml`.
---
🎁 Reward System
* Placeholder Support: 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 - "eco give %player% %random-100-500%" ```
---
📦 Commands & Permissions
✅ Player Command
```plaintext /redeem <code> ```
Redeem a code and claim its reward. ⤷ *Permission: None (available to all players)*
---
🔧 Admin Commands
```plaintext /rc create <code> - Create a new code /rc remove <code> - Remove a code /rc reward - Add/Remove/View rewards /rc sack - Add/Remove/View Sacks /rc event - Add/Remove/Play Events /rc list - List all codes /rc redeemed <code> - Show players who redeemed a code /rc rewards <code> - Show rewards attached to a code /rc reload - Reload plugin configs /rc version - View plugin version /rc show <code> - Show details of a code /rc redeemed <code> [page] - View redeemed users with pagination /rc review <message> - Send a review or bug report to developers /rc gui - Open the RedeemCodes menu interface /rc help [page] - Show the help menu ```
⤷ *Permission: `redeemcodes.admin`*
---
🖥️ GUI System
The plugin includes a modern and easy-to-use GUI for code management:
* Main Menu
* Create Code * Codes List * Admin Panel
* Codes List GUI
* View all available codes at a glance
!
* Code Editor
* Edit rewards, settings, and options directly in-game
---
🛠 Example Code Setup
codes.yml
```yaml
==============================================================================
REDEEM CODES CONFIGURATION
==============================================================================
This file contains all the redemption codes and their settings.
You can create codes using the in-game GUI command: /rc gui
==============================================================================
Codes:
Example Code: "welcome_gift"
Users redeem this by typing: /redeem welcome_gift
welcome_gift:
Enable or disable the code instantly.
enabled: true
Permission Settings [Requires a permission plugin like LuckPerms]
If required is true, the player must have one of the listed permissions.
permisson: required: false list: - code.redeem.welcome
Redemption Limits
Type:
PLAYER -> Limits how many times a single player can redeem.
CODE -> Limits the total global uses of the code (e.g., first 10 people).
redeem-limit: Type: PLAYER Count: 1 # Number of times allowed (Set to -1 for infinite). Cooldown: 0 # Cooldown in minutes between uses (0 to disable). Cooldown-message: "&cYou must wait %Cooldown% before redeeming again!"
Expiration time in seconds. -1 means it never expires.
expire-time: -1
Player Data & Blacklisting
Playerlist: Used: [] # Do not edit manually. Stores UUIDs of players who used the code.
Blacklist Control
Type:
ENABLED -> Players in the list CANNOT use the code.
REVERSE -> Only players in the list CAN use the code (Whitelist mode).
DISABLED -> The list is ignored.
Blacklist: Type: ENABLED List: - notch - herobrine
==========================================================================
REWARDS
==========================================================================
The reward system allows you to mix and match different types of rewards.
#
Distribution Types (rewards.type):
ALL -> The player receives EVERY reward defined below.
RANDOM -> The player receives ONE reward selected randomly from all defined packs.
DRAW -> The player receives ONE reward based on a weighted chance system.
#
Reward Categories:
1. Commands: A list of console commands to execute.
2. Sacks: A collection of items given directly to the inventory (defined in /sacks/).
3. Premades: Reusable command lists defined in premades.yml.
4. Events: Special visual/audio effects defined in /events/.
#
Placeholders for commands:
%player% -> Player Name
%uuid% -> Player UUID
%world% -> World Name
%displayname% -> Display Name
%random-x-y% -> Random number between x and y
==========================================================================
rewards: type: ALL
--- Events ---
Trigger visual/sound effects from files in the 'events' folder.
events: - celebration # Plays 'events/celebration.yml'
--- Command Packs ---
Custom groups of commands specific to this code.
commands: basic_stuff: - "say Welcome %player%!" - "give %player% apple 5" - "weight: 10" # Used if type is DRAW (higher weight = higher chance)
lucky_roll: - "eco give %player% %random-50-100%" - "msg %player% &aYou got some lucky cash!" - "weight: 5"
--- Sacks ---
Items defined in the 'sacks' folder. Format: "sackname:weight"
If type is ALL, weight is ignored.
sacks: - starter: 1 - miner: 1
--- Premades ---
Reusable rewards defined in 'premades.yml'. Format: "premadename:weight"
premades: - vip_rank: 1 - money_small: 2 ```
---
🔊 Configurable Sounds
```yaml sounds: success: ENTITY_PLAYER_LEVELUP failure: BLOCK_ANVIL_LAND ```
---
💬 Fully Customizable Messages
```yaml messages: usage: "&cUsage: /redeem <code>" not-exist: "&cThis code doesn't exist!" blacklisted: "&cYou are not allowed to redeem this code." already-used: "&eYou have already redeemed this code." redeem-success: "&aSuccessfully redeemed the code!" reload-success: "&aAll configuration files reloaded!" no-permission: "&cYou don't have permission to use this." code-exists: "&cCode already exists!" code-created: "&aCreated new code: %code%" code-removed: "&aRemoved code: %code%" reward-added: "&aAdded reward to %code% with ID %id%" reward-removed: "&aRemoved reward ID %id%" reward-not-found: "&cThat reward ID doesn't exist!" invalid-reward-id: "&cInvalid reward ID!" command-usage: "&cUsage: /redeemcodes <command> [arguments]" unknown-action: "&cUnknown action: %action%" code-disabled: "&cThis code is currently disabled." out-of-stock: "&cThis code is out of stock!" code-expired: "&cThis code has expired." ```
---
📚 Requirements
* Minecraft 1.16.5 - 1.21.x * Paper / Purpur
---
📌 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.
