Levelz 占位符 API

Levelz 占位符 API

将LevelZ玩家等级、技能等级、经验值和技能点暴露为占位符API的占位符，用于Fabric服务器上的聊天格式、昵称、侧边栏和标签列表中。

LevelZ 占位符 API

一个轻量级的 Fabric 模组，将玩家的 [LevelZ] 等级、技能等级和经验值暴露为占位符，让你可以在任何支持占位符 API 的地方展示 RPG 进度 —— 聊天、昵称、记分板、侧边栏和标签列表。

占位符

占位符 输出 示例
%levelz:level% 玩家总等级 42
%levelz:skill_level <skill>% 特定技能的等级 %levelz:skill_level mining% → 15
%levelz:xp% 当前经验值 1234
%levelz:skill_points% 未使用的技能点 3

还没有 LevelZ 数据的新玩家将显示 0，而不会抛出错误。

依赖要求

使用示例

StyledChat 格式：

"chat_format": "[✦] Lv.%levelz:level% %player:displayname% ❯ %message%"

侧边栏（StyledSidebars）：

{
  "title": "Player Info",
  "entries": [
    "Level: %levelz:level%",
    "Mining: %levelz:skill_level mining%"
  ]
}

昵称 / 标签列表： 将 %levelz:level% 或 %levelz:skill_level <skill>% 拖入任何样式化占位符文本字段中。

备注

  • 仅服务端模组。客户端无需安装。
  • LevelZ 没有提供稳定的公共 API，因此此模组直接读取其内部数据结构。将 LevelZ 更新到新的主版本可能也需要更新此模组 —— 在线上服务器更新 LevelZ 之前，请先查看更新日志。
  • 技能名称与你的 LevelZ 配置/数据包中注册的名称一致（包括自 LevelZ 2.0.0 起通过数据包添加的自定义技能）。

源码与问题反馈

请在 GitHub 仓库 上报告错误或请求功能。

类别

工具库, 库

加载器

Fabric

游戏版本

1.21.1

许可证

MIT

依赖关系

必需：Fabric API、Placeholder API、LevelZ