Skip to content

PlaceholderAPI 变量

安装并启用 PlaceholderAPI 后,变量统一使用 %lyld_变量名% 格式。

动态丹方或丹药 ID 直接放在变量末尾。ID 中的下划线无需转义,会作为 ID 的一部分保留。

例如,丹方 ID 为 示例_丹方 时,变量为 %lyld_recipe_level_示例_丹方%

丹方变量

变量返回值
%lyld_recipe_learned_<丹方ID>%玩家是否可以使用该丹方。公开丹方或已学会的丹方返回 true,否则返回 false
%lyld_recipe_level_<丹方ID>%当前熟练度等级。玩家未解锁或丹方不存在时返回 0
%lyld_recipe_experience_<丹方ID>%当前等级经验。玩家未解锁或丹方不存在时返回 0
%lyld_recipe_next_level_<丹方ID>%下一熟练度等级。达到最高可实现等级时返回当前等级。
%lyld_recipe_next_experience_<丹方ID>%升到下一等级所需经验。达到最高可实现等级时返回 0
%lyld_recipe_max_level_<丹方ID>%该丹方可以实现的最高熟练度等级。最高等级由丹方 level-bonus 的最终可实现档位决定。
%lyld_recipe_time_<丹方ID>%当前熟练度等级的炼制时间,已应用玩家权限时间倍率,单位为秒。
%lyld_recipe_next_time_<丹方ID>%下一熟练度等级的炼制时间,已应用玩家权限时间倍率,单位为秒。达到最高可实现等级时返回 0

丹药与玩家变量

变量返回值
%lyld_medicine_count_<丹药ID>%玩家当前服用该丹药的累计次数。
%lyld_known_recipe_count%玩家可以查看的丹方数量,包括公开丹方和已经学会的丹方。
%lyld_consumed_medicine_count%玩家已有服用记录的丹药种类数量。
%lyld_exploration_cooldown%探索冷却剩余时间,单位为秒。

当前炼制任务变量

变量返回值
%lyld_crafting_status%是否存在当前炼制任务,返回 truefalse
%lyld_crafting_recipe%当前炼制任务的丹方 ID。无任务时返回空文本。
%lyld_crafting_level%当前炼制任务开始时的丹方熟练度等级。无任务时返回 0
%lyld_crafting_remaining%当前炼制任务剩余时间,单位为秒。炼制中返回剩余秒数;无任务或任务状态为 READY 时返回 0
%lyld_crafting_time%当前炼制任务的总炼制时间,已应用权限时间倍率,单位为秒。无任务时返回 0
%lyld_crafting_finish_time%当前炼制任务完成时间的 Unix 毫秒时间戳。无任务时返回 0
%lyld_crafting_claim_status%当前任务状态:CRAFTINGREADYCLAIMING;无任务时返回 NONE
%lyld_crafting_product%当前任务已确定的丹药配置 ID。尚未确定或无任务时返回空文本。
%lyld_crafting_loop%当前炼制任务是否开启循环炼制。无任务时返回 false。循环开关只在当前在线会话中生效。

返回规则

%lyld_recipe_learned_<丹方ID>% 外,丹方变量在玩家未解锁或目标丹方不存在时返回 0

未知变量不会影响其它 PlaceholderAPI 变量的解析。

如果启用 MySQL 玩家数据存储,必须安装并启用 LyMySQLCore,并确保数据库连接成功;否则依赖玩家数据的变量无法正常生效。mysql.enable 的存储模式在插件启动时确定,修改后需要重启服务器。