```
兑换代码并领取其奖励。
⤷ *权限：无（所有玩家可用）*
---
### 🔧 管理员命令
```plaintext
/rc create - 创建新代码
/rc remove - 删除代码
/rc addreward - 向代码添加奖励命令
/rc removereward - 通过 ID 删除奖励
/rc list - 列出所有代码
/rc redeemed - 显示兑换了该代码的玩家
/rc rewards - 显示附加到该代码的奖励
/rc reload - 重新加载插件配置
/rc version - 查看插件版本
```
⤷ *权限：`op`*
---
## 🖥️ GUI 系统
该插件包含一个现代且易于使用的 GUI，用于代码管理：
* **主菜单**
* 创建代码
* 代码列表
* 管理员命令
* **代码列表 GUI**
* 一目了然地查看所有可用代码
!
* **代码编辑器**
* 直接在游戏中编辑奖励、设置和选项
---
## 🛠 代码设置示例
codes.yml
```yaml
Codes:
samplecode:
enabled: true
permisson:
required: false
list:
- code.sample.redeem
redeem-limit:
Type: PLAYER
Count: 1
Cooldown: 5
Cooldown-message: "&cYou must wait %Cooldown% before redeeming again!"
Playerlist:
Used: []
Blacklist:
Type: ENABLED
List:
- reyalp
rewards:
- say %player% redeemed with UUID %uuid%
- give %player% diamond %random-1-5%
```
---
## 🔊 可配置的声音
```yaml
sounds:
success: ENTITY_PLAYER_LEVELUP
failure: BLOCK_ANVIL_LAND
```
---
## 💬 完全可定制的消息
```yaml
messages:
redeem-success: "&aSuccessfully redeemed the code!"
already-used: "&eYou have already redeemed this code."
blacklisted: "&cYou are not allowed to redeem this code."
code-disabled: "&cThis code is currently disabled."
out-of-stock: "&cThis code is out of stock!"
```
---
## 📚 要求
* Minecraft 1.20.2+
* Paper / Spigot / Purpur / Bukkit
---
## 📌 为什么使用 RedeemCodes？
无论您是在组织活动、赠品、忠诚度计划还是简单的玩家奖励，RedeemCodes 都提供了一种无缝、轻量级和可定制的方式来吸引您的服务器社区。 
# 🌟 RedeemCodes – 易于使用且功能强大的 Minecraft 代码兑换插件
**RedeemCodes** 是一个轻量级但功能强大的插件，允许服务器管理员创建、管理和兑换自定义代码以奖励玩家。
---
## 🔧 特性
* 🎟️ **自定义可兑换代码** – 定义无限数量的代码，并具有灵活的奖励选项。
* ⛔ **黑名单/白名单系统** – 针对每个代码阻止或允许特定玩家。
* 🔄 **兑换限制和冷却时间** – 设置每位玩家或全局兑换限制，并带有冷却计时器。
* 🎨 **交互式 GUI 编辑器** – 在直观的游戏内 GUI 中直接管理代码和奖励。
* 🔊 **成功和错误声音** – 在成功或失败兑换时播放的可配置声音。
* 🧩 **占位符支持** – 在奖励命令中使用占位符，如 `%player%`、`%uuid%`、`%random-min-max%` 等。
* 🔐 **基于权限的访问** – 所有管理员命令都完全受权限保护。
* 🧠 **完全可配置** – 在 `config.yml` 中自定义所有消息、声音和前缀。
---
## 🎁 奖励系统
* **控制台命令**: 奖励被分配为控制台命令，创造无限的可能性而没有限制。
* **占位符支持**: 支持占位符，为命令添加自定义值。
---
## 🧩 支持的占位符
* `%player%` – 玩家名称
* `%uuid%` – 玩家 UUID
* `%displayname%` – 玩家显示名称
* `%world%` – 世界名称
* `%random-min-max%` – 范围内的随机数字
奖励示例：
```yaml
- "eco give %player% %random-100-500%"
```
---
## 📦 命令 & 权限
### ✅ 玩家命令
```plaintext
/redeem