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 coollugo coollugo Nov 27, 2014 at 15:55 UTC - 0 likes

    Hey, So I need help on BarAPI because every time I start my server and a player joins, the BarAPI starts to spam up the console, and it's pretty annoying. now, whenever a player is using commands, I can't see who or what they are doing because BarAPI is spamming the consle. Besides, it usually causes my server to crash and like millions of WARNS or ERRORS start to pop up every second! Everything is fine, it's working fine, but the console is messed up A LOT!

  • Avatar of tjbruce tjbruce Nov 27, 2014 at 09:04 UTC - 0 likes

    Bossmessage has suddenly stopped working now on Spigot... When you face the ground the boss bar disappears and broadcast/schedule task doesn't work. Please fix if you can. Thnaks very much!! :D

  • Avatar of ChillerKraft ChillerKraft Nov 25, 2014 at 18:59 UTC - 0 likes i keep getting this error on server shutdown

  • Avatar of Curtainf2f Curtainf2f Nov 25, 2014 at 04:59 UTC - 0 likes

    On (spigot 1649).
    Use BarAPI v3.2 and Mythicmobs v1.1.4, call Bossbar will be forced to close client.
    Use BarAPI v3.2 and Itemlorestats v4.67 call Bossbar, Bossbar may be disappear and console have so many warning.

                                                                       Forgive my poor English.

  • Avatar of confuserr confuserr Nov 22, 2014 at 19:11 UTC - 0 likes

    @DamianMMC: Go

    Perhaps you could learn to read? 3.2 fixes the issue.

    @ericgolde555: Go

    Unfortunately invisibility potions do not work on ender dragons. Whether or not that in itself is a bug too, I don't know.

  • Avatar of DamianMMC DamianMMC Nov 21, 2014 at 00:29 UTC - 0 likes

    to many Errors:

    please fix this error :(

  • Avatar of ericgolde555 ericgolde555 Nov 20, 2014 at 05:20 UTC - 1 like

    for the 1.8 client caveat, can you put a invisibility potion on the ender dragon so 1.8 clients don't see the enderdragon flying around?

    Last edited Nov 21, 2014 by ericgolde555
  • Avatar of confuserr confuserr Nov 19, 2014 at 15:49 UTC - 0 likes

    Those that are messaging me about this 'issue' and also posting comments about it.

    3.2 specifically states the following known caveat:

    "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 BrutalNetwork BrutalNetwork Nov 19, 2014 at 07:21 UTC - 0 likes

    @RaeEU: Go

    I'm getting this same issue. When everything is setup i usually see the dragon in front of me instead of under the void

  • Avatar of RaeEU RaeEU Nov 18, 2014 at 19:14 UTC - 0 likes

    Note that after latest update from Developer builds, everyone sees an ender dragon flying far away. But the console error on Spigot 1.8 patches is fixed.


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