配置说明

配置文件路径：plugins/LyDragonBoost/config.yml

LyDragonBoost 的配置主要控制血量百分比格式、PlaceholderAPI 变量刷新间隔和定时刷新列表。修改配置后，可以使用 /lhzq reload 重载配置。该指令仅限服务器管理员使用。

配置文件

# lhb_health_rate 变量的小数点位数
# 例如：%.1f 表示保留 1 位小数，%.2f 表示保留 2 位小数
rate-placeholder-format: '%.0f'

# 刷新变量的间隔，单位为 tick
# 20 tick 约等于 1 秒
update-placeholder-interval: 5

# 会进行刷新的 PlaceholderAPI 变量
# 此处不需要写首尾的 %
update-placeholder-list:
  # 本插件自带的血量变量
  - 'lhb_health_rate:{uuid}'
  - 'lhb_health_round:{uuid}'
  - 'lhb_health_max_round:{uuid}'

  # 经过 LSP 变量缩写插件缩写后的血量变量
  - 'lsp_lhb_health_round:{uuid}'
  - 'lsp_lhb_health_max_round:{uuid}'

  # 查询其他玩家的变量
  # - 'lhb_look_{name}:player_level'

  # 查询 MythicMobs 怪物配置中的节点
  # - 'lhb_mm_{uuid}:怪物称号'

  # 查询 AttributePlus 属性
  # - 'lhb_ap_{uuid}:攻击力:min'
  # - 'lhb_ap_{uuid}:攻击力:max'

基础选项

配置键	默认值	说明
rate-placeholder-format	%.0f	设置 lhb_health_rate 返回值的数字格式。血量百分比会先计算为 0 到 100 之间的数值，再按照该格式输出。%.0f 表示不保留小数，%.1f 表示保留 1 位小数，%.2f 表示保留 2 位小数。
update-placeholder-interval	5	定时刷新列表的间隔，单位为 tick。数值越小，刷新越频繁，也会增加处理开销。20 tick 约等于 1 秒。
update-placeholder-list	配置文件中的示例列表	需要定时计算并同步给玩家的 PlaceholderAPI 变量列表。列表为空时不会创建定时刷新任务。

update-placeholder-list

列表中的变量不需要写外层 %。插件会在处理时自动拼接为 PlaceholderAPI 格式，并将结果同步给在线玩家。

插件会遍历在线玩家所在世界的生物实体，只处理满足以下条件的实体：

• 实体未死亡。
• 实体与在线玩家的距离不超过 50。
• 实体属于可生存实体，即 Bukkit 的 LivingEntity。

每个列表项都会先替换动态参数，再交给 PlaceholderAPI 解析。建议只保留实际需要刷新的变量，避免增加不必要的处理开销。

动态参数

参数	替换内容
{uuid}	当前实体的 UUID。
{name}	当前实体的名称。对于玩家实体，通常为玩家名称。
{type}	当前实体的 Bukkit 实体类型名称。玩家实体对应 PLAYER。

示例：

update-placeholder-list:
  - 'lhb_health_rate:{uuid}'
  - 'lhb_health_round:{uuid}'
  - 'lhb_health_max_round:{uuid}'

血量变量

LyDragonBoost 注册的 PlaceholderAPI 标识符为 lhb。

变量	说明
%lhb_health_round:<实体UUID>%	返回实体当前生命值，按整数格式输出。无法找到对应可生存实体时返回 0。
%lhb_health_max_round:<实体UUID>%	返回实体最大生命值，按整数格式输出。无法找到对应可生存实体时返回 0。
%lhb_health_rate:<实体UUID>%	返回实体当前生命值百分比，计算范围为 0 到 100，输出格式由 rate-placeholder-format 控制。无法找到对应可生存实体时返回空字符串。

在刷新列表中使用时，需要去掉外层 %，并使用 {uuid} 动态替换实体 UUID：

update-placeholder-list:
  - 'lhb_health_round:{uuid}'
  - 'lhb_health_max_round:{uuid}'
  - 'lhb_health_rate:{uuid}'

查询其他玩家变量

使用以下格式查询指定玩家的 PlaceholderAPI 变量：

lhb_look_{name}:变量名

写法	说明
lhb_look_{name}:player_level	查询名称为 {name} 的在线玩家的 player_level 变量。

示例：

update-placeholder-list:
  - 'lhb_look_{name}:player_level'

{name} 会替换为当前遍历实体的名称。目标玩家必须在线；找不到目标玩家时返回空字符串。查询结果由 PlaceholderAPI 在目标玩家身上解析。

查询 MythicMobs 怪物配置

使用以下格式读取指定 MythicMobs 怪物的配置节点：

lhb_mm_{uuid}:配置节点

写法	说明
lhb_mm_{uuid}:怪物称号	读取指定 UUID 对应的 MythicMobs 活跃怪物类型配置中的 怪物称号 节点。

示例：

update-placeholder-list:
  - 'lhb_mm_{uuid}:怪物称号'

读取规则如下：

• {uuid} 会替换为当前实体 UUID。
• 目标 UUID 必须对应 MythicMobs 的活跃怪物。
• 配置节点不存在时返回空字符串。
• 字符串形式的列表节点会合并为多行文本。
• 返回内容中的 & 会转换为 Minecraft 颜色符号。

查询 AttributePlus 属性

使用以下格式查询实体的 AttributePlus 属性：

lhb_ap_{uuid}:属性名
lhb_ap_{uuid}:属性名:min
lhb_ap_{uuid}:属性名:max

写法	说明
lhb_ap_{uuid}:攻击力	返回指定实体 攻击力 属性的最小值。
lhb_ap_{uuid}:攻击力:min	返回指定实体 攻击力 属性的最小值。
lhb_ap_{uuid}:攻击力:max	返回指定实体 攻击力 属性的最大值。

示例：

update-placeholder-list:
  - 'lhb_ap_{uuid}:攻击力:min'
  - 'lhb_ap_{uuid}:攻击力:max'

实体不存在或不是可生存实体时返回空字符串。未指定 min 或 max 时，插件返回该属性数据中的最小值。

依赖说明

不同变量功能依赖对应插件：

功能	依赖
PlaceholderAPI 变量解析与注册	PlaceholderAPI
将刷新后的变量同步到 DragonCore 界面	DragonCore
查询 AttributePlus 属性	AttributePlus
查询 MythicMobs 怪物配置	MythicMobs

PlaceholderAPI 和 DragonCore 未启动时，插件会在控制台提示对应状态。未安装或未启用相关依赖时，对应功能无法正常使用。

配置建议

• 只显示血量时，保留 lhb_health_round:{uuid}、lhb_health_max_round:{uuid} 和 lhb_health_rate:{uuid}。
• 需要显示血量百分比的小数时，修改 rate-placeholder-format，例如 %.1f 或 %.2f。
• 不需要刷新的变量应从 update-placeholder-list 中删除，以减少定时处理开销。
• update-placeholder-interval 不建议设置得过短；配置文件说明中以 1 秒等于 20 tick 作为换算参考。