- 版权类型
- 原创
- 插件中文名称
- 礼品码
- 插件英文名称
- GiftCode
- 支持的核心(服务端)
- Paper
- Folia
- Purpur
- Leaves
- 语言支持
- 多语言
- 适配版本(Java)
- 26.x
- 1.21
- 1.20
[MD]
# 🎁 GiftCode 🎁
一款现代化、轻量级且高度可定制的 Minecraft 服务器礼包码 / 兑换码插件。
[](https://mc.wunanc.top/giftcode/)
[](https://github.com/WunancStudio/GiftCode)
[](https://bstats.org/plugin/bukkit/GiftCode/30358)
[](https://github.com/WunancStudio/GiftCode/releases/latest)
[](https://modrinth.com/project/ozJTYG4R)
[](https://www.spigotmc.org/resources/giftcode.133723/)

[](https://deepwiki.com/WunancStudio/GiftCode)
---
中文(简体) | [English](Introduction.md)
## GiftCode 是什么?
GiftCode 允许服主生成专属礼包码,玩家输入后即可获得物品、游戏币或执行特定指令。插件全面采用 **MiniMessage** 格式渲染消息,让你的提示信息拥有炫酷的颜色与渐变效果,告别单调的纯文本。
## 支持版本
- Minecraft `1.20.1+`
- 服务端软件:**Paper**、**Folia**(兼容 Bukkit/Spigot 接口)
## ✨ 核心特性
- **富文本支持:** 全面采用现代化 MiniMessage 语法,支持 `<gradient>`、`<rainbow>`、悬停文本等。
- **灵活的奖励机制:** 可给予物品、发放游戏币、执行后台指令或授予临时权限。
- **丰富的限制条件:** 为每个礼包码设置全局兑换次数、单人兑换次数或过期时间。
- **极致性能:** 采用异步任务处理数据存储,保证主线程(TPS)不卡顿。
- **开发者 API:** 提供完善的 API,方便其他插件进行深度集成。
## 📥 安装指南
1. 前往 [Releases](https://github.com/WunancStudio/GiftCode/releases/latest) 页面下载最新版本的 `GiftCode-x.x.x.jar`。
2. 将下载的 `.jar` 文件放入服务器的 `plugins` 文件夹中。
3. 重启服务器以生成默认配置文件。
4. 按需修改 `config.yml`,然后使用 `/gc reload` 重载即可生效。
## 🚀 指令与权限
| 指令 | 说明 | 权限节点 |
|:----------------------------|:-----------------------|:---------------------------|
| `/gc <兑换码>` | 玩家兑换礼包 | `giftcode.use`(默认拥有) |
| `/gc create <item/cmd> ...` | 创建新的礼包码 | `giftcode.admin` |
| `/gc hand ...` | 编辑指定礼包码 | `giftcode.admin` |
| `/gc delete <兑换码>` | 删除指定礼包码 | `giftcode.admin` |
| `/gc clear` | 清理过期和无效的礼包码 | `giftcode.admin` |
| `/gc list` | 列出所有礼包码 | `giftcode.admin` |
| `/gc reload` | 重载配置文件 | `giftcode.admin` |
## 📄 许可证
本项目采用 MIT 许可证,详见 [LICENSE](https://github.com/WunancStudio/GiftCode/blob/master/LICENSE) 文件。
## 👥 贡献者
<a href="https://github.com/WunancStudio/GiftCode/graphs/contributors">
<img src="https://contrib.rocks/image?repo=WunancStudio/GiftCode" alt="贡献者列表"/>
</a>
## 📞 支持与反馈
- 🐛 [报告 Bug](https://github.com/WunancStudio/GiftCode/issues)
- 💡 [功能建议](https://github.com/WunancStudio/GiftCode/issues)
- 🐧 [QQ 群](https://qm.qq.com/q/OQ33f3SHeg)
## bStats Statics

[/MD]