Server Owners

This plugin does nothing on its own. It is simply an API for other plugins to implement with.


Simply add BarAPI.jar to your project build path.

This plugin makes use of reflection and therefore "shouldn't" break on craftbukkit updates.


The message can not be more than 64 characters. If it is more, BarAPI will automatically cut it to 64 characters to prevent the client from crashing.

This is a client limitation and cannot be changed.


BarAPI.setMessage(Player player, String message)

Set a message for the player. It will remain there until the player logs off or another plugin overrides it.

BarAPI.setMessage(Player player, String message, float percent)

Same as above except you can set the % of the health bar. 100 shows the entire health bar, 50 shows half the health bar and so on.

BarAPI.setMessage(final Player player, String message, int seconds)

Sets a timed message for the player. It will remain until the timer runs out. The health automatically reduces based on how long the timer is.

BarAPI.hasBar(Player player)

Pretty self explanatory, returns a boolean.

BarAPI.removeBar(Player player)

Also pretty self explanatory.

BarAPI.setHealth(Player player, float percent)

Allows you to modify the health of an existing bar. If the player has no bar, this does nothing.


German - DerFeliix






Developer Builds

These builds have not been approved by BukkitDev staff, therefore, use at your own risk.

Frostcast CI


This plugin contains an auto updater which is enabled by default. If you do not wish to automatically download new updates, edit BarAPI/config.yml and set autoUpdate to false.

To Dos

  • Scroll messages if string is greater than 64 characters.

Plugins Using BarAPI






PvPGames Automated


Infernal Mobs





Item Lore Stats



Battle Of Blocks






To determine popularity and usage of BarAPI, plugin installs are automatically tracked by the Metrics plugin tracking system. Your Java version, OS, player count, server country location and plugin & server versions are collected. This is used to determine what environments are using the plugin to ensure full compatibility. This collection is anonymous. If you don't want this tracking, edit plugins/PluginMetrics/config.yml and set opt-out to true.

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

  • Avatar of madprofessor83 madprofessor83 Jul 12, 2015 at 08:31 UTC - 0 likes

    @Adrimuvi: Go

    I swear. It took me forever to figure out what was causing that bug. I finally figured it out.

  • Avatar of Adrimuvi Adrimuvi Jul 07, 2015 at 14:09 UTC - 1 like

    you can fix the bug to enderdragon? It is annoying and ugly

  • Avatar of geilNico geilNico Jun 19, 2015 at 16:41 UTC - 0 likes

    I can´t use Multiverse, if i used your API.

    Please help me. There ist no error in the console

  • Avatar of Kocacola97 Kocacola97 Jun 13, 2015 at 21:00 UTC - 2 likes

    @ComandanteEver1: Go

    Not that you are using a 1.7 server with a 1.8 barapi... ;)

  • Avatar of ComandanteEver1 ComandanteEver1 Jun 13, 2015 at 14:08 UTC - 0 likes

    This plugin does not work ..

    1. [15:39:34] [Server thread/WARN]: java.lang.NoSuchMethodException: net.minecraft.server.v1_7_R4.PacketPlayOutEntityTeleport.<init>(int, int, int, int, byte, byte, boolean, boolean)
      [15:39:34] [Server thread/WARN]: at java.lang.Class.getConstructor0(Unknown Source)
      [15:39:34] [Server thread/WARN]: at java.lang.Class.getConstructor(Unknown Source)
      [15:39:34] [Server thread/WARN]: at me.confuser.barapi.nms.v1_8Fake.getTeleportPacket(
      [15:39:34] [Server thread/WARN]: at me.confuser.barapi.BarAPI.sendDragon(
      [15:39:34] [Server thread/WARN]: at me.confuser.barapi.BarAPI.setMessage(
      [15:39:34] [Server thread/WARN]: at hub.Hub$
      [15:39:34] [Server thread/WARN]: at
      [15:39:34] [Server thread/WARN]: at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftScheduler.mainThreadHeartbeat(
      [15:39:34] [Server thread/WARN]: at net.minecraft.server.v1_7_R4.MinecraftServer.v(
      [15:39:34] [Server thread/WARN]: at net.minecraft.server.v1_7_R4.DedicatedServer.v(
      [15:39:34] [Server thread/WARN]: at net.minecraft.server.v1_7_R4.MinecraftServer.u(
      [15:39:34] [Server thread/WARN]: at
      [15:39:34] [Server thread/WARN]: at
  • Avatar of games647 games647 Jun 02, 2015 at 11:19 UTC - 0 likes

    Could you add mcMMOExtras to the plugin list?

  • Avatar of TheIntelloBox TheIntelloBox May 30, 2015 at 07:45 UTC - 0 likes

    Update to 1.8.6 please !

  • Avatar of fr233 fr233 May 29, 2015 at 17:47 UTC - 0 likes

    cant work with 1.8.3,i have tested all the plugins use barapi,they cant work.

  • Avatar of gpotter2 gpotter2 Apr 14, 2015 at 17:04 UTC - 0 likes

    @SwaG1KinG: Go

    OMG, again ?

    The plugin is having issues with 1.8...

    The plugin may print error codes... And may not works...

    please read the "known issues":

    Due to a client side bug with 1.8, the bar is only visible to a player if they are looking at the enderdragon. This means players will be able to see an enderdragon in the distance

    You may follow the error here:

    Last edited Apr 23, 2015 by gpotter2

    Code is code, it is not pizza...



  • Avatar of SwaG1KinG SwaG1KinG Apr 08, 2015 at 18:32 UTC - 0 likes

    Plugin MEGA Spam || Issues

    The plugin is spamming my console like CRAZY. And the most important the dragon get spawns not far from the players and they can see him...

    Can someone please help me? (Yes i am using the spigot 1.8.x & 1.7.x server version and the config has that enabled!)

    Thanks in advance.



Date created
Sep 01, 2013
Last update
Dec 19, 2014
Development stage
Creative Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales
Curse link
Recent files