Redeem Codes [⭐Gui]

Minecraft 版本： 1.8.8 1.8.9 1.9 1.9.1 1.9.2 1.9.3 1.9.4 1.10 1.10.1 1.10.2 1.11 1.11.1 1.11.2 1.12 1.12.1 1.12.2 1.13 1.13.1 1.13.2 1.14 1.14.1 1.14.2 1.14.3 1.14.4 1.15 1.15.1 1.15.2 1.16 1.16.1 1.16.2 1.16.3 1.16.4 1.16.5 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit folia paper purpur spigot

标签： economy management utility

RedeemCodes is a 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:

- "eco give %player% %random-100-500%"

---

? Commands & Permissions

✅ Player Command

/redeem <code>

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

---

? Admin Commands

/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

sounds:
  success: ENTITY_PLAYER_LEVELUP
  failure: BLOCK_ANVIL_LAND

---

? Fully Customizable Messages

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.8.8+
• Server Software: Paper, Purpur, Spigot, Bukkit, Folia

---

? 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.