插件变量

LyDragonSkillView 注册了 PlaceholderAPI 变量扩展，变量标识为 ldsv。完整变量格式为 %ldsv_变量名%，动态变量需要将占位符中的参数替换为实际键位或技能 ID。

这些变量可用于 PlaceholderAPI，也可被 DragonCore 界面、技能栏、读条界面和技能详情界面读取。

玩家数据尚未初始化、技能不存在或当前没有选中技能时，部分变量会返回空字符串或 0。未识别的变量会返回错误文本。

玩家数据

变量	返回内容
%ldsv_skill_point%	玩家当前技能点数量。
%ldsv_mana_now%	玩家当前蓝量。
%ldsv_mana_max%	玩家最大蓝量。
%ldsv_gcd%	玩家全局公共冷却剩余时间，单位为秒，保留 1 位小数。冷却结束后返回 0.0。
%ldsv_gcdScale%	玩家全局公共冷却剩余比例，范围为 0 到 1。
%ldsv_class_id%	玩家当前职业 ID。未设置职业时返回空字符串。
%ldsv_class_tag%	当前职业在 config.yml 的 class-setting.<职业ID>.tag 中配置的称号。未设置职业或找不到称号时返回空字符串。

读条数据

以下变量用于读取玩家当前正在进行的主动技能读条状态。瞬发技能不会保留读条状态。

变量	返回内容
%ldsv_boot_skill%	当前读条技能的显示名称。没有正在读条的技能时返回空字符串。
%ldsv_boot_scale%	当前读条进度比例，范围为 0 到 1。
%ldsv_boot_elapsed%	当前读条已用时间，单位为秒，保留 1 位小数。
%ldsv_boot_total%	当前读条总时间，单位为秒，保留 1 位小数。
%ldsv_boot_count%	当前读条已触发的读条段数。

%ldsv_boot_trigger_count% 不属于当前实现提供的变量，请使用 %ldsv_boot_count% 读取当前读条段数。

技能栏数据

将 {键位} 替换为玩家技能栏中实际使用的键位名称。键位需要与 config.yml 的 bind-key 配置一致，例如 Q、R、Z、X、C 或 V。

变量模板	返回内容
%ldsv_skillbar_icon_{键位}%	指定键位绑定技能的贴图路径。没有绑定技能时返回 0,0,0,0。
%ldsv_skillbar_charge_{键位}%	指定键位绑定技能当前可用的充能层数。没有绑定技能时返回 0。
%ldsv_skillbar_skill_id_{键位}%	指定键位绑定技能的技能 ID。没有绑定技能时返回空字符串。
%ldsv_skillbar_skill_name_{键位}%	指定键位绑定技能的显示名称。没有绑定技能时返回空字符串。
%ldsv_skillbar_cooldown_{键位}%	指定键位技能下次恢复所需的剩余时间，单位为秒，保留 1 位小数。
%ldsv_skillbar_cooldownScale_{键位}%	指定键位技能下次恢复的剩余比例，范围为 0 到 1。

cooldown 和 cooldownScale 的读取规则如下：

• 多层充能技能读取下一层充能的剩余时间或剩余比例。
• 单层技能优先读取当前技能冷却；没有当前冷却时读取下一层充能倒计时。
• 剩余比例会根据当前等级配置的冷却时间计算，并应用玩家的冷却缩减属性。

指定技能数据

将 {技能ID} 替换为技能文件中的顶层技能节点名，例如 示例主动技能。技能 ID 必须与技能配置中的顶层节点名完全一致。

变量模板	返回内容
%ldsv_skill_level_{技能ID}%	指定技能的当前原始等级，不包含额外等级加成。技能不存在时返回 0。
%ldsv_skill_max_level_{技能ID}%	指定技能配置中的最大可学习等级，即 max-level。技能不存在时返回 0。
%ldsv_skill_extra_level_{技能ID}%	指定技能的额外等级加成，即有效等级减去原始等级。
%ldsv_skill_result_level_{技能ID}%	指定技能的最终有效等级，即原始等级加上额外等级。
%ldsv_skill_name_{技能ID}%	指定技能的显示名称，即技能配置中的 name。技能不存在时返回空字符串。

额外等级来自技能配置中的 extra-level-placeholder。插件会根据玩家上下文解析 PlaceholderAPI 变量和四则运算表达式，并将结果四舍五入为整数。

当前选中技能

这些变量读取玩家当前在技能菜单或技能界面中选中的技能，常用于技能详情面板。

变量	返回内容
%ldsv_selected_skill_name%	当前选中技能的显示名称。
%ldsv_selected_skill_texture%	当前选中技能的贴图路径。
%ldsv_selected_skill_level%	当前选中技能的当前原始等级，不包含额外等级加成。
%ldsv_selected_skill_extra_level%	当前选中技能的额外等级加成，即有效等级减去原始等级。
%ldsv_selected_skill_result_level%	当前选中技能的最终有效等级，即原始等级加上额外等级。
%ldsv_selected_skill_max_level%	当前选中技能配置中的最大可学习等级。
%ldsv_selected_upgrade_condition%	当前选中技能下一个已配置等级的升级条件显示文本，多条条件使用换行连接。

升级条件变量

%ldsv_selected_upgrade_condition% 读取的是当前原始等级之后、已配置的最小等级节点中的 upgrade-list 显示文本：

• 只显示升级规则中 | 后面的文本。
• item:{物品名#数量} 规则支持替换显示文本中的 {item} 和 {amount}。
• 当前技能已达到最大等级，或不存在下一个已配置等级时，返回 config.yml 中 upgrade-condition-full-level-text 的内容；该配置为空时使用 技能已满级。
• 显示文本会继续解析玩家的 PlaceholderAPI 变量。
• 当前没有选中技能时返回空字符串。

使用格式

静态变量直接使用完整变量名：

%ldsv_skill_point%
%ldsv_mana_now%
%ldsv_selected_skill_name%

动态变量需要替换参数：

%ldsv_skillbar_skill_name_Q%
%ldsv_skillbar_cooldownScale_Q%
%ldsv_skill_level_示例主动技能%
%ldsv_skill_result_level_示例主动技能%

技能 ID 来源于技能文件的顶层节点，键位来源于 config.yml 的 bind-key 配置。