Looking for a new dev to take over!

Team-based player tags for Bukkit servers.


BattleTags introduces a vibrant new way to differentiate between players with popular team-based plugins. Players will see others' name tags colored to match their team, group, faction or town.

Note: Color codes take up 2 character spaces; any name longer than 14 characters will be shortened.


Currently, BattleTags works with the following plugins:

  • Factions by Brettflan: Tags are based on faction relations, according to the colors you've specified with Factions. Players will see a difference between allies, enemies, members and neutrals of their faction.
  • SimpleClans by phaed420: Legacy support for below CraftBukkit 1.4.6-R1.0. Clan relations determine tag colors, as defined in the BattleTags config.yml file. Players will see a difference between allies, enemies, rivals and warring clans.
  • SimpleClans2 by p000ison: Clan relations determine tag colors, as defined in the BattleTags config.yml file. Players will see a difference between allies, enemies, rivals and warring clans.
  • Towny Advanced by ElgarL: Requires development build or greater. Tags are based on nation relations, as defined in the BattleTags config.yml file. Players will see a difference between allies and enemies.
  • HealthBar by filoghost: Up close tags are as defined in healthbar, far away is like normal battletags. Both names will have the colors from the relation. Some healthbar configurations might not work.
    - Confirmed broken -> Sets health to 0
  • War by tommytony: Tags are based on team colors.


This plugin requires TagAPI or ProtocolLib to change the color of player tags.
This plugin requires TabAPI or ProtocolLib to modify the player tablist!
There is one command, /bt reload (battletags.reload), which defaults to op. It's drag, drop, and go!


Commits are welcome on Github!

Check here for more information. If reporting a bug or suggesting a feature, please file a ticket.


- xTeam compatibility - needs testing
- Make tab list with colored names GROUPED
- BattleArena compatibility - needs testing
- myRPG compatibility
- McMMO power level compatibility and party/alliance members tags


Do you get an error looking like this:
"08.01 14:51:01 [Server] WARN at me.happypikachu.BattleTags.managers.BattleTagsProtocolTabManager$1.onPacketSending(

08.01 14:51:01 [Server] WARN at

08.01 14:51:01 [Server] WARN com.comphenix.protocol.reflect.FieldAccessException: Field index must be within 0 - count"

Then update your protocollib to the latest >DEV< build from here

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of marubal21 marubal21 Aug 28, 2014 at 13:40 UTC - 0 likes

    Does this plugin still work with the latest changes to factions?

    Legends of Talaria

  • Avatar of Mateix27 Mateix27 Jul 11, 2014 at 19:49 UTC - 0 likes

    Does this plugin support mcMMO-TagAPI? If not, please add support or additional feature :) Thanks!

    Last edited Jul 11, 2014 by Mateix27
  • Avatar of Proxwian Proxwian Jul 09, 2014 at 10:15 UTC - 0 likes

    Please add HeroStronghold compatibility! Thanks

  • Avatar of kwek20 kwek20 Jun 25, 2014 at 21:19 UTC - 0 likes

    Sorry guys, i still cant find any time, maybe in 2 weeks. If anyone wants to take this over or help me with it, feel free to ask!
  • Avatar of sakura_blades sakura_blades Jun 24, 2014 at 14:22 UTC - 0 likes

    This doesn't seem to be working with HealthBars after all >.>;
    After testing whether it was protocollib or this plugin that was interfering with HealthBars I can confirm it is indeed this plugin that is resetting HeathBars' HP display to 0.

  • Avatar of sakura_blades sakura_blades Jun 22, 2014 at 14:17 UTC - 0 likes

    Oh this is a wonderful plugin!

    I LOVE that it's compatible with HealthBar! Especially now that I see you plan to add McMMO support as well. :o

    Lots of my players create Parties, and I have Towns too though, so just a heads up that i think the McMMO should over-ride whatever Towny's color tag would be.. To avoid any confusion.. Just for future reference.

    Does this plugin itself have an API or does it hook into other Plugins to change appropriately? I may have a request depending on this.

  • Avatar of BotQ BotQ May 08, 2014 at 08:30 UTC - 0 likes

    Can you add faction's tag to players tags? Btw, awesome plugin,thank you. :)

  • Avatar of zorro8003 zorro8003 Apr 29, 2014 at 14:48 UTC - 0 likes

    Please add name faction with tags players to Factions...

  • Avatar of LOLniqqa LOLniqqa Apr 29, 2014 at 12:08 UTC - 0 likes

    If you could add support for all HealthBar configurations that would be great, I really like this plugin, keep up the good work! :)

  • Avatar of kwek20 kwek20 Mar 27, 2014 at 22:59 UTC - 0 likes

    @Xickle: Go

    Great to hear! Thanks for the feedback.

    I will hopefully find some time to look into those bugs ;)


Date created
Oct 10, 2012
Last update
Mar 06, 2014
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files



Optional dependency