AFXPlugins AFXPlugins / CustomPlayerNametags logo CustomPlayerNametags v1.0.0
Getting started

Installation

Follow this guide to install CustomPlayerNametags

1. Install dependencies

Download the following plugins and move them into /plugins:

PluginWhy
PacketEvents requiredIt 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 advisedAllows 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

  1. Download CustomPlayerNametags.
  2. Place it in your server's /plugins folder, alongside PacketEvents and PlaceholderAPI.
  3. 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/:

FilePurpose
config.ymlUsed 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.