promotional bannermobile promotional banner

Levelz Placeholder API

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

The Levelz Placeholder API Team

profile avatar
  • 3
    Projects
  • 144
    Downloads

Indonesia

More from mikhaildhns