PlayerName Styler

PlayerName Styler

Add configurable nicknames and styled player names across chat, tab list, and above-head nameplates.

Features

- Nameplate renderer is configurable (`/nickname`) - Nameplate renderer is configurable for chat, tab list, and nameplates (TOML) - Nameplate renderer is configurable (built-ins + API for other mods to register their own placeholders) - Nameplate renderer is configurable - Minecraft `&` color/format codes (`&a`, `&6`, `&l`, `&r`, etc.) - Hex colors (`&#RRGGBB` and `<#RRGGBB>`) - Tags like `<bold>`, `<red>`, `<reset>` - `<gradient:#RRGGBB:#RRGGBB>text</gradient>` and `<rainbow>text</rainbow>` - Nameplate renderer is configurable *(optional via `%prefix%` / `%suffix%`; empty when LuckPerms is not installed)* - Nameplate renderer is configurable in your config folder (`config/nicknames.json`) - Nameplate renderer is configurable with `/realname` - Nameplate renderer is configurable (`text_display` default, with `armor_stand` fallback)

Commands

- `/nickname` — show your current nickname - `/nickname <nickname>` — set your nickname - `/nickname clear` — clear your nickname - `/nickname set <player> <nickname>` — admin set (OP level 2) - `/nickname clear <player>` — admin clear (OP level 2) - `/nickname reload` — reload nicknames file (OP level 2) - `/realname` — list all nicknames - `/realname <search>` — search nickname/real name

Configuration

Config file: `config/playernamestyler-common.toml`

- `chatFormat`, `tabListFormat`, `nameplateFormat` accept placeholders like: - `%displayname%`, `%username%`, `%prefix%`, `%suffix%`, `%chatmessage%` - `%world%` / `%dimension%`, `%biome%`, `%ping%`, `%x%/%y%/%z%`, `%health%`, etc. - `nameplateRenderer` can be `text_display` or `armor_stand`

Compatibility

- Minecraft: NeoForge - Minecraft: 1.21.1–1.21.11 (separate build per listed version)