跳到主要内容

快速开始

安装

  1. 服务端需要支持 Bukkit API(Spigot / Paper 等)
  2. CDKLite.jar 放入服务器的 plugins/ 目录
  3. 重启服务器(不建议热加载)
提示

CDKLite 内置 TabooLib 6.3.0-5880b4c,不需要单独安装 TabooLib 前置。首次启动后插件会自动生成默认配置文件。

目录结构

首次启动后,plugins/CDKLite/ 目录下会生成以下文件:

plugins/CDKLite/
├── config.yml # 主配置文件(数据库、通用设置、跨服同步)
├── reward.yml # 奖励包配置文件
├── gui.yml # GUI 标题、布局和按钮模板
└── lang/
└── zh_CN.yml # 中文语言文件

运行过程中还可能生成以下文件:

plugins/CDKLite/
├── data.db # SQLite 模式的数据文件
├── sync-state.yml # MySQL 跨服同步游标记录
└── cdk_yyyy-MM-dd-HH-mm-ss.yml # createMulti 批量生成记录

快速上手

1. 创建一个 CDK

给在线玩家 Steve 创建一个绑定 礼包1 奖励包的 CDK:

/cdklite create Steve 礼包1

系统会根据 config.yml 中的 random_cdk 模板自动生成兑换码。

你也可以指定自定义兑换码:

/cdklite create Steve 礼包1 MY-CUSTOM-CODE

2. 玩家兑换

其他玩家输入兑换码即可领取奖励:

/cdk MY-CUSTOM-CODE

兑换后,使用者(Receiver)立即执行 receive 中定义的 Kether 动作。

3. 拥有者结算

CDK 拥有者(Owner)上线后结算累积的奖励:

/cdklite reward

结算时执行 owner 中定义的 Kether 动作,&amount 变量为本次结算的数量。

下一步

  1. 打开 config.yml,根据需要调整数据库、基础设置和跨服同步 → 配置文件说明
  2. 编辑 reward.yml 配置你的奖励包 → 奖励包系统
  3. 如需调整菜单标题、布局和按钮文案,编辑 gui.ymlGUI 管理面板
  4. 进入游戏,使用 /cdklite gui 打开管理面板,或查看 命令参考 了解所有可用命令