Levelz Placeholder API

# 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