CustomPlayerNametags
A Paper plugin that lets you fully customize player nametags. Includes global, group, and individual player formats, PlaceholderAPI support, and Bedrock compatibility.
What it does
Fully custom nametags
Replace the entire vanilla player nametag display entirely with a custom format.
Global, group, and individual player formats
Set a global nametag-format as a default format for the whole server. Additionally set custom formats for LuckPerms groups, as well as individual players.
Player edit system
Allow players to edit their nametags by including widgets in their format, which allows them to add items inside of them, while preventing editing any item outside.
Advanced customization
Create nametags with many different colors and placeholders, as well as ones that span multiple lines.
Requirements
| Dependency | Role | Notes |
|---|---|---|
| PacketEvents required | Core packet handling | Allows editing nametag packets— the plugin will not work without it. |
| PlaceholderAPI strongly advised | Placeholder resolution | Not required for the plugin to load, but without it only individual player formats work: global and group formats are ignored, and %placeholder% values are not resolved. |
| LuckPerms optional | Group nametag formats | Not required, but allows setting group formats for LuckPerms permission groups. |
Explore the Docs
Installation
Install the plugin, dependencies, and verify everything is working.
Nametag Formats
Learn how to format and customize nametags.
Configuration
Every config.yml setting, from formats and Bedrock options to nametag behavior.
Commands
View all /nametags commands and how to use them.
Permissions
Manage access to plugin commands and features.
Troubleshooting
Troubleshooting tips for common plugin issues.