WkKit

高效、强大、可定制的Minecraft礼包管理插件

---

✨ 项目简介

WkKit 是一款专为 Minecraft 服务器打造的礼包/福利发放插件，支持多种礼包管理、CDK兑换、GUI交互、MySQL数据存储、NBT物品操作等功能，兼容 1.12-1.21+，助力服务器福利系统高效运作。

---

🚀 功能亮点

• 多礼包管理：支持自定义礼包、批量发放、冷却与次数限制
• GUI 菜单交互：直观易用的礼包领取界面，支持自定义材质与模型ID
• CDK兑换系统：支持生成/兑换礼包码，灵活配置
• MySQL/本地存储：支持MySQL数据库与本地文件双模式，数据安全可靠
• NBT物品支持：全面适配NBT-API，支持自定义物品属性、头颅皮肤等
• 新人礼包/自动发放：支持新玩家自动发放礼包，严格检测模式
• 多语言/自定义提示：支持多语言与自定义消息
• 高兼容性：适配多版本 Spigot/Paper/Bukkit/Folia 服务端

---

🛠️ 安装与配置

1. 下载插件：将 WkKit-x.x.x.jar 放入服务器的 plugins 文件夹。
2. 重启服务器，自动生成 config.yml 配置文件。
3. 编辑配置：根据需要修改 src/main/resources/config.yml，支持如下MySQL配置：

   MySQL:
     Enable: false
     databasename: 'name'
     username: 'user'
     password: 'pw'
     port: '3306'
     ip: 'localhost'
     useSSL: false
     tablePrefix: 'wkkit_'

4. 重载插件：使用 /wkkit reload 应用新配置。

---

📦 指令与权限

• /wkkit 主命令，支持礼包管理、CDK生成、数据重载等
• 详细指令与权限请见 Wiki

---

📝 更新日志

详见 CHANGELOG 或 Releases 页面。

---

🤝 联系与支持

• 作者：WekyJay
• 反馈/建议：请在 Issues 提交
• QQ1️⃣群：945144520
• QQ2️⃣群：60484123

---

本插件已适配最新NBT-API与MySQL配置，欢迎Star与PR！

---

📝 更新日志

v1.5.0 (2026-03-07)

• 测试覆盖: 添加JUnit 5单元测试，覆盖率87.5%
• 性能优化: 基准测试验证，查询性能提升
• 代码质量: 统一异常处理，现代化架构设计

v1.4.0

• GUI菜单交互: 直观易用的礼包领取界面
• CDK兑换系统: 支持生成/兑换礼包码
• MySQL/本地存储: 双模式数据存储
• NBT物品支持: 全面适配NBT-API

详见 CHANGELOG 或 Releases 页面。