跳到正文

Levelz Placeholder API

作者:mikhaildhns

Exposes LevelZ player level, skill levels, XP, and skill points as Placeholder API placeholders for use in chat formats, nicknames, sidebars, and tab lists on Fabric servers.

收藏

介绍

中文介绍正在准备中,下面暂时显示原文。

 

# LevelZ Placeholder API

A lightweight Fabric mod that exposes a player's [LevelZ] 
level, skill levels, and experience as placeholders, so you can show RPG progression anywhere 
Placeholder API is supported — chat, nicknames, scoreboards, sidebars, and tab lists.

## Placeholders

| Placeholder | Output | Example |
|---|---|---|
| `%levelz:level%` | Player's overall level | `42` |
| `%levelz:skill_level <skill>%` | Level for a specific skill | `%levelz:skill_level mining%` → `15` |
| `%levelz:xp%` | Current XP | `1234` |
| `%levelz:skill_points%` | Unspent skill points | `3` |

New players with no LevelZ data yet will show `0` instead of throwing errors.

## Requirements

- Fabric Loader ≥ 0.16.0
- Minecraft 1.21.1
- [Fabric API](https://modrinth.com/mod/fabric-api)
- [Placeholder API](https://modrinth.com/mod/placeholder-api) ≥ 2.4.0
- [LevelZ](https://modrinth.com/mod/levelz) (Cloth Config & LibZ are bundled with LevelZ itself)

## Example Usage

**StyledChat format:**

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

 

**Sidebar (StyledSidebars):**
```json
{
  "title": "Player Info",
  "entries": [
    "Level: %levelz:level%",
    "Mining: %levelz:skill_level mining%"
  ]
}
```

**Nicknames / tab list:** drop `%levelz:level%` or `%levelz:skill_level <skill>%` into any 
styled placeholder text field.

## Notes

- Server-side only mod. No client installation needed.
- LevelZ doesn't expose a stable public API, so this mod reads its internal data structures 
  directly. Updating LevelZ to a new major version may require an update to this mod as well — 
  check the changelog before updating LevelZ on a live server.
- Skill names match whatever is registered in your LevelZ config/datapack (including custom 
  skills added via datapack since LevelZ 2.0.0).

## Source & Issues

Report bugs or request features on the [GitHub repository](#).

Categories

 
Utility, Library

Loaders

 
Fabric

Game Versions

 
1.21.1

License

 
MIT

Dependencies

 
Required: Fabric API, Placeholder API, LevelZ

常见问题

Levelz Placeholder API 支持哪些 Minecraft 版本?

Levelz Placeholder API 支持 Minecraft Java 版 1.21.1,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。

Levelz Placeholder API 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

mikhaildhns 的其他作品

查看全部 →