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.
  • 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 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 ;)
  • Avatar of Xickle Xickle Mar 27, 2014 at 22:09 UTC - 0 likes

    I'm trying to use BattleTags with xTeam, and can give you some feedback! For one, a team is selected/changed the player names only appear in a different color after a relog. And players with no team are displayed as red/hostile. That's the only two bugs I found so far.

  • Avatar of smokeymcjay smokeymcjay Mar 10, 2014 at 02:32 UTC - 0 likes

    do you think you could add RacesandClasses integration?


  • Avatar of kwek20 kwek20 Mar 09, 2014 at 22:04 UTC - 0 likes

    @predawnia: Go

    Added it to the todo list ;)

  • Avatar of predawnia predawnia Mar 09, 2014 at 06:47 UTC - 0 likes

    Can you make it compatible with mcMMO? The Power Levels doesn't show with BattleTags installed

    Project: Zombie Afterlife - The real zombie server, totally hardcore survival and Factions PVP server

  • Avatar of kwek20 kwek20 Mar 05, 2014 at 19:21 UTC - 0 likes

    @MURD3RUS: Go

    A fix is coming soon, just cant squash the last bug :/ but the memory loss is not caused by BattleTags, since the code didnt change, tagAPI did. You can also try to jsut remove tagAPI and install ProtocolLib.

    As for the memory loss, try to install spigot and use their timings commands (

  • Avatar of MURD3RUS MURD3RUS Mar 04, 2014 at 23:12 UTC - 0 likes

    Console coming up with an error upon boot-up and occasionally crashing the server after sucking up all my memory.

    [BattleTags] Enabling BattleTags v2.6
    [BattleTags] Hooked into Factions 2.3.0
    [BattleTags] "BattleTags v2.6" has registered a listener for org.kitteh.tag.PlayerReceiveNameTagEvent on method "public void me.happypikachu.BattleTags.managers.BattleTagsAPIManager.onNameTag(org.kitteh.tag.PlayerReceiveNameTagEvent)", but the event is Deprecated. "Server performance will be affected"; please notify the authors [HappyPikachu, kwek20].
    [BattleTags] Activated integration with TagAPI
    [BattleTags] Activated integration with TabAPI

    Last edited Mar 04, 2014 by MURD3RUS
  • Avatar of 13Nick13nick1313 13Nick13nick1313 Mar 03, 2014 at 23:12 UTC - 0 likes

    BattleTags isn't compatible with HealthBars after 1.7 (confirmed).

  • Avatar of kwek20 kwek20 Feb 16, 2014 at 00:02 UTC - 0 likes

    10k downloads 0.o

  • Avatar of kwek20 kwek20 Feb 01, 2014 at 21:01 UTC - 0 likes

    @Preii: Go

    Will also add it to the list XD But its getting quite long :S


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