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.
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
Code (Text):
%player%
,
Code (Text):
%uuid%
, and
Code (Text):
%random-min-max%
.
Permission-Based Access – All admin commands are fully permission protected.
Fully Configurable – Customize all messages, sounds, and prefix in
Code (Text):
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
Code (Text):
%player%
– Player's name
Code (Text):
%uuid%
– Player's UUID
Code (Text):
%displayname%
– Player's display name
Code (Text):
%world%
– World name
Code (Text):
%random-min-max%
– Random number within a range
Example Reward:
Code (Text):
- "eco give %player% %random-100-500%"
Commands & Permissions ✅ Player Command
Code (Text):
/redeem <code>
Redeem a code and claim its reward.
Permission: None (available to all players) Admin Commands Permission:
Code (Text):
redeemcodes.admin
Code (Text):
/rc create <code> - Create a new code
/rc remove <code> - Remove a code
/rc addreward <code> <cmd> - Add a reward command to a code
/rc removereward <code> <id> - Remove a reward by ID
/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 review <message> - Send a review/bug report
/rc gui - Open the RedeemCodes menu interface
/rc help [page] - Show the help menu
️ 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)
Configuration
Code (Text):
# Example structure for creating a redemption code.
Codes:
samplecode: # The name of the code.
enabled: true
# If the player needs a certain permission to use the code.
permisson:
required: false
list:
- code.sample.redeem
redeem-limit:
# Types: PLAYER (per player) or CODE (global limit)
Type: PLAYER
Count: 1 # Set to -1 for no limit.
Cooldown: 5 # Minutes
Cooldown-message: "&cYou must wait %Cooldown% before redeeming again!"
expire-time: -1 # Seconds until expiration (-1 for none)
Playerlist:
Used: [] # Backup list of players.
# Blacklist or Whitelist mode
Blacklist:
Type: ENABLED
List:
- reyalp
# Console commands to run on redeem
rewards:
- say %player% (%uuid%) is in %world% with name %displayname%
- give %player% diamond %random-1-5%
Code (Text):
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-disabled: "&cThis code is currently disabled."
out-of-stock: "&cThis code is out of stock!"
code-expired: "&cThis code has expired."
Requirements
Minecraft 1.20.2 - 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.