PlayerName Styler

PlayerName Styler

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

Features

• Per-player nicknames (/nickname)
• Configurable formatting for chat, tab list, and nameplates (TOML)
• Placeholder system (built-ins + API for other mods to register their own placeholders)

• Styling support

  • Minecraft & color/format codes (&a, &6, &l, &r, etc.)
  • Hex colors (&#RRGGBB and <#RRGGBB>)
  • Tags like `, , `
  • `<gradient:#RRGGBB:#RRGGBB>textandtext`
• LuckPerms prefix/suffix integration (optional via %prefix% / %suffix%; empty when LuckPerms is not installed)
• Simple JSON nickname storage in your config folder (config/nicknames.json)
• Real username lookup with /realname
• Nameplate renderer is configurable (text_display default, with armor_stand fallback)
• Scoreboard below_name support — shows the below_name display slot (e.g. health) as a second line under custom nameplates, which Minecraft otherwise hides once the name tag is replaced

Commands

• /nickname — show your current nickname
• `/nickname ` — set your nickname
• /nickname clear — clear your nickname
• `/nickname set ` — admin set (OP level 2)
• `/nickname clear ` — admin clear (OP level 2)
• /nickname reload — reload nicknames file (OP level 2)
• /nickname cleartags — remove stuck/orphaned nameplate entities and refresh online players (OP level 2)
• /realname — list all nicknames
• `/realname ` — 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
• showBelowName toggles the scoreboard below_name line under custom nameplates (default true)

Compatibility

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