- 版权类型
- 原创
- 插件中文名称
- 魂之CDK
- 插件英文名称
- SoulCDK
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]
# SoulCDK
一个基于 TabooLib 开发的 Minecraft CDK(兑换码)插件,支持命令与 GUI 管理、条件校验、脚本奖励和数据库持久化。
## 功能特性
- 随机生成 CDK(支持数量、使用次数、有效期、备注)
- 自定义 CDK(支持格式校验与重复校验)
- 兑换限制(单人单码、冷却时间、过期时间、使用上限)
- 奖励发放
- Kether 脚本
- 物品奖励(原版/NeigeItems/MythicMobs)
- 全服广播
- 条件校验
- Placeholder 条件表达式
- 背包空位
- 权限节点
- GUI 管理(查看、编辑、删除、创建)
- 数据库存储(SQLite / MySQL)
## 运行环境
- Java 8+
- Bukkit 系服务端(Spigot / Paper 等)
- TabooLib 6.2.4(项目内构建)
可选依赖(按功能启用):
- PlaceholderAPI(`requirements.check`)
- SweetMail(物品邮件发放)
- NeigeItems(`Items` 中 `ni` 类型)
- MythicMobs(`Items` 中 `mm` 类型)
## 安装
1. 构建或获取 `SoulCDK` 插件 Jar。
2. 放入服务器 `plugins` 目录。
3. 重启服务器。
4. 首次启动后编辑 `config.yml`、`rewards.yml`。
## 命令
主命令:`/soulcdk`(别名:`/cdk`)
| 命令 | 说明 |
|------|------|
| `/cdk` | 显示命令帮助(TabooLib helper) |
| `/cdk create <类型> [数量] [使用次数] [有效期] [备注]` | 随机生成 CDK |
| `/cdk custom <兑换码> <类型> [使用次数] [有效期] [备注]` | 创建自定义 CDK |
| `/cdk use <兑换码>` | 兑换 CDK |
| `/cdk delete <兑换码>` | 删除 CDK |
| `/cdk edit <兑换码> [类型] [使用次数] [有效期] [备注]` | 编辑 CDK |
| `/cdk info <兑换码>` | 查看 CDK 详情 |
| `/cdk history [页码]` | 查看玩家兑换历史 |
| `/cdk clean` | 清理过期 CDK |
| `/cdk reload` | 重载 `config.yml`、`rewards.yml`(含 SweetMail 发件人/标题/正文) |
| `/cdk gui` | 打开管理 GUI |
有效期参数格式(单单位):
- `7d`(天)
- `12h`(小时)
- `30m`(分钟)
- `45s`(秒)
## 权限节点
> 当前代码中每个子命令都有独立权限。
| 权限 | 对应命令 |
|------|----------|
| `soulcdk.main` | `/cdk` |
| `soulcdk.create` | `/cdk create` |
| `soulcdk.custom` | `/cdk custom` |
| `soulcdk.use` | `/cdk use` |
| `soulcdk.delete` | `/cdk delete` |
| `soulcdk.edit` | `/cdk edit` |
| `soulcdk.info` | `/cdk info` |
| `soulcdk.history` | `/cdk history` |
| `soulcdk.clean` | `/cdk clean` |
| `soulcdk.reload` | `/cdk reload` |
| `soulcdk.gui` | `/cdk gui` |
[/MD]