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 confuserr confuserr Aug 28, 2015 at 10:18 UTC - 0 likes

    I'll say this once more...

    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

  • Avatar of markellamichalatou markellamichalatou Aug 20, 2015 at 14:15 UTC - 0 likes

    Can you do something with the enderdragon bug? It appears every time I use the bar.

  • 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.


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