How do I install PlayerName Styler?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Modrinth — not every file is mirrored on our own servers.

What Minecraft version does PlayerName Styler work with?

The listing gives Minecraft 1.21.4. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›PlayerName Styler

ModsJava

PlayerName Styler

by HiSierra · on Modrinth

⬇ Download on Modrinth

Open in MC Java Mods Get it on Google Play →

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 <bold>, <red>, <reset>
- <gradient:#RRGGBB:#RRGGBB>text</gradient> and <rainbow>text</rainbow>
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 <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)
/nickname cleartags — remove stuck/orphaned nameplate entities and refresh online players (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
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)

Example of Styled Nickname

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft version listed: 1.21.4
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

Ships as playernamestyler-2.0.3-mc1.21.4.jar — drop this file into the mods folder
Download size: 111 KB
Download link checked 30 Aug 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.21