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% | 是否存在当前炼制任务,返回 true 或 false。 |
%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% | 当前任务状态:CRAFTING、READY、CLAIMING;无任务时返回 NONE。 |
%lyld_crafting_product% | 当前任务已确定的丹药配置 ID。尚未确定或无任务时返回空文本。 |
%lyld_crafting_loop% | 当前炼制任务是否开启循环炼制。无任务时返回 false。循环开关只在当前在线会话中生效。 |
返回规则
除 %lyld_recipe_learned_<丹方ID>% 外,丹方变量在玩家未解锁或目标丹方不存在时返回 0。
未知变量不会影响其它 PlaceholderAPI 变量的解析。
如果启用 MySQL 玩家数据存储,必须安装并启用 LyMySQLCore,并确保数据库连接成功;否则依赖玩家数据的变量无法正常生效。mysql.enable 的存储模式在插件启动时确定,修改后需要重启服务器。