原创 开源 工具 经济 GiftCode——为你的服务器添加兑换码功能! 完全支持Folia! v2.0.0

[MD] # 🎁GiftCode [](https://mc.wunanc.top/giftcode/) [](https://github.com/wunanc/GiftCode) [](https://bstats.org/plugin/bukkit/GiftCode/30358) [](https://github.com/wunanc/GiftCode/releases/latest) [](https://modrinth.com/project/ozJTYG4R) [](https://www.spigotmc.org/resources/giftcode.133723/)  [](https://deepwiki.com/wunanc/GiftCode) --- 中文（简体） | [English](README.md) ## 简介 一款现代化、轻量级且高度可定制的 Minecraft 服务器礼包码/兑换码插件。 GiftCode 允许服主生成专属礼包码，玩家输入后可获得物品、游戏币或执行特定指令。插件全面支持 **MiniMessage** 格式，让你的提示信息拥有炫酷的颜色和渐变效果！ ## 支持版本 - 1.20.1+ (Paper、Folia) ## ✨ 核心特性 - **富文本支持:** 全面采用现代化的 MiniMessage 语法（支持 `<gradient>`, `<rainbow>` 等）。 - **灵活的奖励机制:** 支持执行后台指令、给予物品或临时权限。 - **丰富的限制条件:** 可设置礼包码的全局兑换次数、单人兑换次数或过期时间。 - **极致性能:** 采用异步任务处理数据存储，保证主线程（TPS）不卡顿。 - **开发者 API:** 提供完善的 API，方便其他插件进行深度集成。 ## 📥 安装指南 1. 前往[Releases](https://github.com/wunanc/GiftCode/releases) 页面下载最新版本的 `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` | ## 🛠️ 源码构建 如果你想在本地编译此项目，你需要安装 JDK 17+ 以及相应的构建工具 Maven： ```bash git clone https://github.com/wunanc/GiftCode.git cd GiftCode mvn clean package ``` ### 📄 许可证 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。 ### 👥 作者 - **wunanc | Hotguo** - *主要开发者* ### 🙏 鸣谢 感谢所有为本项目做出贡献的开发者和用户！ ### 📞 支持与反馈 - 🐛 [报告 Bug](https://github.com/wunanc/GiftCode/issues) - 💡 [功能建议](https://github.com/wunanc/GiftCode/issues) - 🐧 [QQ 群](https://qm.qq.com/q/OQ33f3SHeg) - 📧 联系作者：通过 GitHub Issues --- **由 Hotguo 用 ❤️ 制作** ⭐ 如果你喜欢这个项目，不妨给它点个 Star！ [](https://bstats.org/plugin/bukkit/GiftCode) [/MD]