插件变量

LyItemLoreCommand 可通过 PlaceholderAPI 提供冷却组剩余时间变量。插件注册的 PlaceholderAPI 标识符为 lilc。

使用这些变量前，需要安装并启用 PlaceholderAPI。PlaceholderAPI 未启用时，LyItemLoreCommand 不会注册这些变量。

冷却变量

变量	返回内容
%lilc_cd-<冷却组>%	返回玩家指定冷却组的剩余时间。显示格式由 countdown-format 配置决定。
%lilc_cdint-<冷却组>%	返回玩家指定冷却组的剩余整数秒。

<冷却组>必须替换为检测节点中的 cd-team 值。插件会按照玩家当前保存的冷却组数据读取对应剩余时间。

变量需要在玩家上下文中解析，例如聊天、记分板、菜单或其他能够提供玩家对象的 PlaceholderAPI 使用场景。

返回规则

• 玩家没有对应冷却组数据时，变量返回 0。
• 对应冷却组的冷却时间已经结束时，变量返回 0。
• 冷却剩余时间小于 0 秒时，插件会按 0 秒处理。
• 无法获取玩家对象时，变量返回空内容。
• 未匹配到插件支持的变量格式时，变量返回空内容。
• 冷却组名称按照配置值读取，变量中的名称需要与 cd-team 完全对应。

时间格式

countdown-format: true

%lilc_cd-<冷却组>% 返回 mm:ss 格式：

• 分钟和秒数均按两位显示。
• 剩余时间按整数秒计算，小数部分不显示。
• 例如剩余时间约为 65 秒时，返回 01:05。

countdown-format: false

%lilc_cd-<冷却组>% 返回保留一位小数的秒数：

• 例如剩余时间约为 65 秒时，返回 65.0。
• 返回值使用当前配置重新格式化，不使用 mm:ss 格式。

整数变量

%lilc_cdint-<冷却组>% 始终返回整数秒，不受 countdown-format 配置影响。

返回值使用整数格式化处理。例如剩余时间约为 65 秒时，返回 65。

配置关联

冷却组由检测节点中的 cd-team 配置：

config:
  检测节点:
    cd-team: '技能A'

对应变量为：

%lilc_cd-技能A%
%lilc_cdint-技能A%

如果检测节点未填写 cd-team，插件默认使用冷却组 默认。对应变量为：

%lilc_cd-默认%
%lilc_cdint-默认%

冷却组数据由插件自身保存。启用 mysql.enable 后，插件会将玩家冷却组数据保存到 MySQL，实现跨服共享冷却数据；此模式必须安装 LyMySQLCore，并且数据库连接成功后相关功能才会生效。

变量解析流程

1. PlaceholderAPI 读取 lilc 标识符下的变量内容。
2. 插件从变量中识别 cd- 或 cdint- 前缀。
3. 插件使用前缀后的内容作为冷却组名称。
4. 插件读取当前玩家对应冷却组的冷却结束时间。
5. 插件根据变量类型和 countdown-format 配置返回结果。

变量格式中的尖括号仅表示占位说明，实际使用时不要保留尖括号。