CDKLiteAPI 方法列表
所有方法通过 CDKLiteAPI 对象直接调用。带 async 前缀的方法为异步版本，内部自动切换到异步线程执行。
兑换
| 方法签名 | 说明 |
|---|---|
receiveCdk(player: Player, cdk: String) | 同步兑换 CDK |
asyncReceive(player: Player, cdk: String) | 异步兑换 CDK |
// 推荐使用异步版本
CDKLiteAPI.asyncReceive(player, "ABCD-1234-EFGH")
创建
| 方法签名 | 说明 |
|---|---|
createCdk(owner: Player, cdk: String, reward: String, sender: CommandSender?) | 同步创建 CDK |
asyncCreate(owner: Player, cdk: String, reward: String, sender: CommandSender?) | 异步创建 CDK |
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
owner | Player | CDK 所有者 |
cdk | String | CDK 字符串 |
reward | String | 奖励配置名称 |
sender | CommandSender? | 命令发送者（用于反馈消息），可为 null |
CDKLiteAPI.asyncCreate(player, "VIP-2024-GIFT", "vip_monthly", null)
查询
| 方法签名 | 说明 |
|---|---|
infoCdk(player: Player, sender: CommandSender?) | 查询玩家的 CDK 信息 |
asyncInfo(player: Player, sender: CommandSender?) | 异步查询玩家的 CDK 信息 |
infoConsoleCdk(sender: CommandSender?) | 查询控制台 CDK 信息 |
CDKLiteAPI.asyncInfo(player, sender)
奖励结算
| 方法签名 | 说明 |
|---|---|
reward(name: String) | 按名称获取奖励配置并结算 |
rewardConsole() | 结算控制台奖励 |
CDKLiteAPI.reward("vip_reward")
CDK 管理
| 方法签名 | 说明 |
|---|---|
softDeleteCdk(entity: OwnerEntity) | 软删除 CDK（标记为已移除，不物理删除） |
getConsumeCdk() | 获取所有可消耗的 CDK 列表 |
getRandomCdk(player: Player?) | 生成随机 CDK 字符串 |
generateRecord() | 导出 CDK 兑换记录 |
// 软删除
val entity: OwnerEntity = ...
CDKLiteAPI.softDeleteCdk(entity)
// 生成随机 CDK
val randomCdk = CDKLiteAPI.getRandomCdk(player)
公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
ownerCache | — | CDK 所有者缓存 |
receiveCache | — | CDK 兑换记录缓存 |
receiveConsume | — | 可消耗 CDK 兑换记录 |
警告
公共字段为内部缓存，建议通过 API 方法操作而非直接修改。