欢迎加入MineBBS QQ讨论群：点击查看所有的官方讨论群
MineBBS入站考试已经上线！想要成为【正式会员】解锁更多功能吗？快来参与吧！【点我去看】

原创开源工具经济 KukeCDK - 新一代的轻量化CDK插件，批量创建 | CDK | 礼包码 | 执行指令 | 有效时长 | 批量增/删/改/导出 | 数据库支持 v2.0

完成注册/登录后下载

作者 kukemc
创建日期 2024/11/05
标签

cdk 充值兑换码插件礼包码

概述更新（9）历史版本讨论区

v2.0

2026/06/29

更新日志
新增

新增内置 HTTP API 服务，默认关闭，可在 config.yml 的 api 段开启。

API 支持 CDK 查询、创建、更新、删除、按 ID 删除、按 ID 补货、验证、兑换、日志查询、统计和管理重载。

API 启动后提供内置文档页面，默认访问地址为 http://127.0.0.1:8765/docs。

API 提供 JSON 摘要文档，默认访问地址为 http://127.0.0.1:8765/docs/openapi.json。

新增 Bearer Token 鉴权。

新增 API scope 权限控制，支持 server:read、cdk:read、cdk:create、cdk:update、cdk:delete、cdk:verify、cdk:redeem、log:read、admin:reload 和 *。

新增 API IP 白名单、请求限流、CORS 配置、最大请求体大小限制和审计日志。

新增 CDK 使用条件限制：可要求玩家拥有指定权限或属于指定权限组后才能兑换。

新增 /cdk create 的 --permission <权限> 和 --group <权限组> 可选参数。

改进

升级 AnvilGUI 到 1.10.13-SNAPSHOT，并切换到新的官方 Maven 仓库。

改进铁砧 CDK 输入界面的物品保护，修复 1.21.x 等高版本可能取出 GUI 物品的问题。

铁砧 CDK 输入界面提交时不再触发原版铁砧经验消耗。

API 兑换会通过同步状态变更避免并发重复发奖。

API 涉及在线玩家、权限检查和命令执行的逻辑已切回服务端调度线程执行。

/cdk reload 会同步处理 API 服务重启。

README 和 README.en.md 增加 HTTP API 使用说明。

项目级禁用 Gradle 常驻 daemon，构建结束后自动停止 single-use daemon。

修复

修复 config.yml 中 anvil_gui.output 重复配置键的问题。

补充 kukecdk.admin.migrate 权限声明。

修复 API 默认 token 未修改时仍可能启动的安全风险：现在会拒绝启动并提示修改。

修复 API reload 时可能中断当前响应或泄漏线程池的问题。

修复 API 兑换保存失败后可能发奖或留下错误内存状态的问题。

修复 shadowJar 中可能缺少数据库驱动依赖的问题。

修复铁砧 GUI 点击确认兑换时可能扣除玩家经验等级的问题。

安全提醒

API 默认关闭。启用前请务必修改 api.auth.tokens 中的默认 token。

如果仍使用 change-me-admin-token 或 change-me-readonly-token，API 会拒绝启动。

推荐保持 host 为 127.0.0.1，并使用 Nginx/Caddy 等 HTTPS 反向代理对外暴露。

如果绑定 0.0.0.0，请务必配置 IP 白名单、防火墙和强 token。