A note about the future. 1.8 and beyond

With the changes implemented in 1.8, TagAPI is no longer a good idea. As a result, TagAPI will receive no further updates.

But I want to add colors to usernames!

I suggest finding a plugin that lets you do that using the built-in scoreboard system added to Minecraft in 1.6 which is better suited for that!

But I want to change usernames completely!

Sorry, but Mojang's made it much harder and I don't feel it's worth it to try hacking that in anymore. Best of luck! :)


This plugin is a plugin tool, much like Vault or SpoutPlugin, for providing additional functionality outside the normal bounds of Bukkit API.

What it does

Ever wanted your plugin to display a different color above someone's name? Disguise as another player to tease players? Now you can!

What it doesn't do

  • The name over your head affects your skin. This is a minecraft client issue.
  • Change entity ID. This means that someone with a modified client can still tell that it's you no matter what name you have.
  • Allow nametags over 16 characters (including color codes! Two per color/format). Another minecraft limitation I can't break.

How to use:

Alright, now that we have got the list of can and can'ts out of the way, here's how to use the plugin.

I run a server

You're probably here because a plugin you want to use offers nametag changing as an additional feature. Just install this plugin and you're good to go. Note that this plugin itself doesn't change anything, just offer the ability for other plugins to do so.

I am a developer

Excellent! Take a look at the tutorial to get started. It's easy to start using this.

Note: Be polite and don't register at a higher event priority unless absolutely necessary. Personally I do this for VanishNoPacket because knowing that a player is vanished is a bit more important than an admin tag or fake name, as it's an administrative plugin. Think carefully about priorities. Most plugins should be fine just checking the event on default priority.

Also important to note, the isModified() method can let you know if another plugin has already played with the name, which can be important. Be polite to other plugins!

Feel free to ask questions in #kitteh.org on esper. Or just click here


Do not include this code in your own plugin but implement this API instead, to avoid code conflicts or other breakages.

Plugins supporting TagAPI

Click here to see a list of plugins


To determine usage, plugin installs are automatically tracked by the mcstats.org plugin tracking system. Data collected is system information, player count, server and plugin version information. It is sent to mcstats.org and your server IP is never revealed, and is used for statistical purposes. If you don't want to send this data, edit plugins/PluginMetrics/config.yml and set opt-out to true.


[ONELINER:Change the name tag of your users!]