搜索

PlaceholderAPI 占位符

完整变量示例、内存快照、经验字段与HUD内部变量区别。

安装兼容的 PlaceholderAPI 后,LiSkills 注册 liskills 前缀。以下是完整可复制格式,不需要额外下载同名扩展。未安装 PlaceholderAPI 不影响技能和内置 HUD。

占位符 含义
%liskills_level_mining% 挖矿等级
%liskills_xp_mining% 当前等级内的经验
%liskills_progress_mining% 同样返回本级经验,不是百分比
%liskills_required_mining% 当前升级需求;满级时为 0
%liskills_total_xp_mining% 按当前经验曲线计算的累计经验
%liskills_total_level% 已启用技能的等级总和
%liskills_mana% 当前可用魔力
%liskills_max_mana% 魔力上限
%liskills_stat_strength% 力量属性值
%liskills_stat_health% 生命属性点,不是玩家实际最大生命
%liskills_ability_bountiful_harvest% 对应被动的当前阶级
%liskills_ability_value_bountiful_harvest% 对应被动的当前主数值

把 mining 换为其他已注册技能 ID,例如 endurance、healing、forging、sorcery,也支持合法的自定义技能。属性 ID 和被动 ID 分别参考 stats.yml 与 abilities.yml。

数据来自哪里

占位符只读取已经加载的内存档案和已发布属性快照,不会为每次占位符请求读磁盘,也不会跨 Folia 区域读取玩家实时背包。未加载、停用或不适用时相关数字可能为 0;未知字段不作为有效变量处理。

累计经验按当前曲线推算,修改曲线后可能改变,并不是不可变的历史入账总账。原版经验等级和技能等级是不同系统。

内置文本不是同一套变量

messages.yml 中的 {health}、{max_health}、{mana}、{skill} 是 LiSkills 对应消息的内部变量,不是 PlaceholderAPI 的百分号变量。各消息只支持其业务提供的变量。

HUD 的生命显示直接使用玩家实际最大生命,包含合法外部加成;若需要 HUD 文本变量和 MiniMessage 配色,见HUD 与安全卸载。