Introducing the Tag API!
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
Copying
I would ask that you do not include this code in your own plugin but implement this API instead, to avoid any plugin conflicts. The last thing I need is having to deal with plugin conflicts on this.
Plugins supporting TagAPI
Developers: Let me know if you support it!
Metrics
To determine usage, plugin installs are automatically tracked by the Metrics plugin tracking system. If you don't want to help or are paranoid, edit plugins/PluginMetrics/config.yml and set opt-out to true.
