# \ud83c\udf1f RedeemCodes \u2013 Easy & Powerful Code Redemption Plugin for Minecraft<\/p>\n
**RedeemCodes** is a powerful plugin that allows server administrators to create, manage, and redeem custom codes to reward players.<\/p>\n
—<\/p>\n
## \ud83d\udd27 Features<\/p>\n
* \ud83c\udf9f\ufe0f **Custom Redeemable Codes** \u2013 Define unlimited codes with flexible reward options.
\n* \u26d4 **Blacklist\/Whitelist System** \u2013 Block or allow specific players for each code.
\n* \ud83d\udd04 **Redemption Limits & Cooldowns** \u2013 Set per-player or global redemption limits with cooldown timers.
\n* \ud83c\udfa8 **Interactive GUI Editor** \u2013 Manage codes and rewards directly in an intuitive in-game GUI.
\n* \ud83d\udd0a **Success & Error Sounds** \u2013 Configurable sounds that play on successful or failed redemption.
\n* \ud83e\udde9 **Placeholder Support** \u2013 Use placeholders like `%player%`, `%uuid%`, `%random-min-max%`, and more inside reward commands.
\n* \ud83d\udd10 **Permission-Based Access** \u2013 All admin commands are fully permission protected.
\n* \ud83e\udde0 **Fully Configurable** \u2013 Customize all messages, sounds, and prefix in `config.yml`.<\/p>\n
—<\/p>\n
## \ud83c\udf81 Reward System<\/p>\n
* **Console Command**: Rewards are assigned as console commands, creating endless possibilities without limitations.
\n* **Placeholder Support**: Supports placeholders to add custom values in commands.<\/p>\n
—<\/p>\n
## \ud83e\udde9 Supported Placeholders<\/p>\n
* `%player%` \u2013 Player’s name
\n* `%uuid%` \u2013 Player’s UUID
\n* `%displayname%` \u2013 Player’s display name
\n* `%world%` \u2013 World name
\n* `%random-min-max%` \u2013 Random number within a range<\/p>\n
Example reward:<\/p>\n
“`yaml
\n– “eco give %player% %random-100-500%”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udce6 Commands & Permissions<\/p>\n
### \u2705 Player Command<\/p>\n
“`plaintext Redeem a code and claim its reward. ---<\/p>\n ### \ud83d\udd27 Admin Commands<\/p>\n ```plaintext \u2937 *Permission: `redeemcodes.admin`*<\/p>\n ---<\/p>\n ## \ud83d\udda5\ufe0f GUI System<\/p>\n The plugin includes a modern and easy-to-use GUI for code management:<\/p>\n * **Main Menu**<\/p>\n * Create Code <\/p>\n * **Codes List GUI**<\/p>\n * View all available codes at a glance<\/p>\n !<\/p>\n * **Code Editor**<\/p>\n * Edit rewards, settings, and options directly in-game<\/p>\n <\/p>\n ---<\/p>\n ## \ud83d\udee0 Example Code Setup<\/p>\n ```yaml Codes: # Enable or disable the code instantly. # Permission Settings [Requires a permission plugin like LuckPerms] # Redemption Limits # Expiration time in seconds. -1 means it never expires. # Player Data & Blacklisting # Blacklist Control # ========================================================================== rewards: # --- Events --- # --- Command Packs --- lucky_roll: # --- Sacks --- # --- Premades --- ---<\/p>\n ## \ud83d\udd0a Configurable Sounds<\/p>\n ```yaml ---<\/p>\n ## \ud83d\udcac Fully Customizable Messages<\/p>\n ```yaml ---<\/p>\n ## \ud83d\udcda Requirements<\/p>\n * Minecraft 1.16.5 - 1.21.x ---<\/p>\n ## \ud83d\udccc Why Use RedeemCodes?<\/p>\n Whether you\u2019re organizing events, giveaways, loyalty programs, or simple player rewards, RedeemCodes offers a seamless, lightweight, and customizable way to engage your server community.<\/p>\n","protected":false},"excerpt":{"rendered":" Best free redeem codes plugin for Minecraft
\n\/redeem
\n```<\/p>\n
\n\u2937 *Permission: None (available to all players)*<\/p>\n
\n\/rc create - Create a new code
\n\/rc remove - Remove a code
\n\/rc reward - Add\/Remove\/View rewards
\n\/rc sack - Add\/Remove\/View Sacks
\n\/rc event - Add\/Remove\/Play Events
\n\/rc list - List all codes
\n\/rc redeemed - Show players who redeemed a code
\n\/rc rewards - Show rewards attached to a code
\n\/rc reload - Reload plugin configs
\n\/rc version - View plugin version
\n\/rc show - Show details of a code
\n\/rc redeemed [page] - View redeemed users with pagination
\n\/rc review
\n\/rc gui - Open the RedeemCodes menu interface
\n\/rc help [page] - Show the help menu
\n```<\/p>\n
\n * Codes List
\n * Admin Panel<\/p>\ncodes.yml<\/summary>\n
\n# ==============================================================================
\n# REDEEM CODES CONFIGURATION
\n# ==============================================================================
\n# This file contains all the redemption codes and their settings.
\n# You can create codes using the in-game GUI command: \/rc gui
\n# ==============================================================================<\/p>\n
\n # Example Code: \"welcome_gift\"
\n # Users redeem this by typing: \/redeem welcome_gift
\n welcome_gift:<\/p>\n
\n enabled: true<\/p>\n
\n # If required is true, the player must have one of the listed permissions.
\n permisson:
\n required: false
\n list:
\n - code.redeem.welcome<\/p>\n
\n # Type:
\n # PLAYER -> Limits how many times a single player can redeem.
\n # CODE -> Limits the total global uses of the code (e.g., first 10 people).
\n redeem-limit:
\n Type: PLAYER
\n Count: 1 # Number of times allowed (Set to -1 for infinite).
\n Cooldown: 0 # Cooldown in minutes between uses (0 to disable).
\n Cooldown-message: \"&cYou must wait %Cooldown% before redeeming again!\"<\/p>\n
\n expire-time: -1<\/p>\n
\n Playerlist:
\n Used: [] # Do not edit manually. Stores UUIDs of players who used the code.<\/p>\n
\n # Type:
\n # ENABLED -> Players in the list CANNOT use the code.
\n # REVERSE -> Only players in the list CAN use the code (Whitelist mode).
\n # DISABLED -> The list is ignored.
\n Blacklist:
\n Type: ENABLED
\n List:
\n - notch
\n - herobrine<\/p>\n
\n # REWARDS
\n # ==========================================================================
\n # The reward system allows you to mix and match different types of rewards.
\n #
\n # Distribution Types (rewards.type):
\n # ALL -> The player receives EVERY reward defined below.
\n # RANDOM -> The player receives ONE reward selected randomly from all defined packs.
\n # DRAW -> The player receives ONE reward based on a weighted chance system.
\n #
\n # Reward Categories:
\n # 1. Commands: A list of console commands to execute.
\n # 2. Sacks: A collection of items given directly to the inventory (defined in \/sacks\/).
\n # 3. Premades: Reusable command lists defined in premades.yml.
\n # 4. Events: Special visual\/audio effects defined in \/events\/.
\n #
\n # Placeholders for commands:
\n # %player% -> Player Name
\n # %uuid% -> Player UUID
\n # %world% -> World Name
\n # %displayname% -> Display Name
\n # %random-x-y% -> Random number between x and y
\n # ==========================================================================<\/p>\n
\n type: ALL<\/p>\n
\n # Trigger visual\/sound effects from files in the 'events' folder.
\n events:
\n - celebration # Plays 'events\/celebration.yml'<\/p>\n
\n # Custom groups of commands specific to this code.
\n commands:
\n basic_stuff:
\n - \"say Welcome %player%!\"
\n - \"give %player% apple 5\"
\n - \"weight: 10\" # Used if type is DRAW (higher weight = higher chance)<\/p>\n
\n - \"eco give %player% %random-50-100%\"
\n - \"msg %player% &aYou got some lucky cash!\"
\n - \"weight: 5\"<\/p>\n
\n # Items defined in the 'sacks' folder. Format: \"sackname:weight\"
\n # If type is ALL, weight is ignored.
\n sacks:
\n - starter: 1
\n - miner: 1<\/p>\n
\n # Reusable rewards defined in 'premades.yml'. Format: \"premadename:weight\"
\n premades:
\n - vip_rank: 1
\n - money_small: 2
\n```<\/p>\n<\/details>\n
\nsounds:
\n success: ENTITY_PLAYER_LEVELUP
\n failure: BLOCK_ANVIL_LAND
\n```<\/p>\n
\nmessages:
\n usage: \"&cUsage: \/redeem \"
\n not-exist: \"&cThis code doesn't exist!\"
\n blacklisted: \"&cYou are not allowed to redeem this code.\"
\n already-used: \"&eYou have already redeemed this code.\"
\n redeem-success: \"&aSuccessfully redeemed the code!\"
\n reload-success: \"&aAll configuration files reloaded!\"
\n no-permission: \"&cYou don't have permission to use this.\"
\n code-exists: \"&cCode already exists!\"
\n code-created: \"&aCreated new code: %code%\"
\n code-removed: \"&aRemoved code: %code%\"
\n reward-added: \"&aAdded reward to %code% with ID %id%\"
\n reward-removed: \"&aRemoved reward ID %id%\"
\n reward-not-found: \"&cThat reward ID doesn't exist!\"
\n invalid-reward-id: \"&cInvalid reward ID!\"
\n command-usage: \"&cUsage: \/redeemcodes
\n unknown-action: \"&cUnknown action: %action%\"
\n code-disabled: \"&cThis code is currently disabled.\"
\n out-of-stock: \"&cThis code is out of stock!\"
\n code-expired: \"&cThis code has expired.\"
\n```<\/p>\n
\n* Paper \/ Purpur<\/p>\n
\n servers<\/p>\n","protected":false},"featured_media":130773,"template":"","meta":{"_minecraft_slug":"redeemcodes","_minecraft_project_id":"WBLeWYAd","_minecraft_author":"RedoxHere","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":1228,"_minecraft_follows":11,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"redeemcodes.zip","_minecraft_size_bytes":796757,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-16T07:57:01.162210Z","_minecraft_date_created":"2025-04-25T01:53:12.827263Z","_minecraft_date_modified":"2025-12-15T20:43:52.218753Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/redeemcodes","_minecraft_icon_attachment_id":130773,"_minecraft_imported_at":"2026-06-07T16:57:23+00:00","_minecraft_import_hash":"dbbe06d465b9aa324a34512632f85ca0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,126,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-130772","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n