Installation
Follow this guide to install CustomPlayerNametags
1. Install dependencies
Download the following plugins and move them into /plugins:
| Plugin | Why |
|---|---|
| PacketEvents required | It allows the plugin to hide vanilla nametags and control them individually for each viewer by sending raw team packets directly to clients, something Bukkit's Scoreboard API cannot do. |
| PlaceholderAPI strongly advised | Allows parsing placeholders in the nametag format. Required for the global format to work, but individual player formats will still work without it. |
2. Add the plugin
- Download
CustomPlayerNametags. - Place it in your server's
/pluginsfolder, alongside PacketEvents and PlaceholderAPI. - Start the server.
3. Verify it loaded
On startup, check your console for:
[CustomPlayerNametags] CustomPlayerNametags enabled.Troubleshooting
If instead you see the server refuse to load the plugin, make sure the latest version of PacketEvents is installed. If it still doesn't work, see Troubleshooting.
Once enabled, it will generate three files in /plugins/CustomPlayerNametags/:
| File | Purpose |
|---|---|
config.yml | Used for editing the CustomPlayerNametags configuration. |
messages.yml* | Stores all plugin messages. |
player-formats.yml* | Stores individual player formats. |
*messages.yml and player-formats.yml can be ignored as they only serve as storage for the plugin.
Full breakdown of each file is on the Configuration page.
CustomPlayerNametags