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 TheRealDiamondPortal TheRealDiamondPortal Mar 31, 2015 at 02:05 UTC - 0 likes

    It wont work on my Spigot 1.8.3 server

  • Avatar of Pugmatt Pugmatt Mar 25, 2015 at 01:56 UTC - 0 likes

    I'm usually one to say "It's better than nothing", but being able to see the enderdragon + hearing its wings is a bit overkill. Thanks for your hard work though.

    Last edited Mar 25, 2015 by Pugmatt


  • Avatar of technowix technowix Mar 15, 2015 at 13:07 UTC - 0 likes

    Possible to spawn the dragon under the ground ?

  • Avatar of CNLY CNLY Mar 14, 2015 at 09:18 UTC - 0 likes

    @Roxas156: Go

    Your server is too old for the plugin. Use 1.7.10 or up for BarAPI v3.3.

  • Avatar of Ancard Ancard Mar 09, 2015 at 07:33 UTC - 0 likes


    xD WTF!? This scared me the first time ... accompanied by the noise of aliens ... but it was awesome ... then I get disconnected when the light came to me ... you can create some plugin to add aliens? I have no idea how to repeat the bug. but I know comes from barAPI. because the bar appeared and disappeared quickly. This light seemed to move arbitrarily. and when he was near started to hear the noise of ender dragon wings flapping very quickly and could see the smoke of thousands of small explosions of ender dragon.

    Last edited Mar 09, 2015 by Ancard
  • Avatar of Roxas156 Roxas156 Mar 04, 2015 at 21:26 UTC - 0 likes

    Hello excuse me but when I stop the server I've this usue,

    [22:20:28 INFO]: [BarAPI] Disabling BarAPI v3.3 [22:20:28 ERROR]: Error occurred while disabling BarAPI v3.3 (Is it up to date?)

    java.lang.NoSuchMethodError: org.bukkit.Server.getOnlinePlayers()Ljava/util/Coll ection; at me.confuser.barapi.BarAPI.onDisable( [?:?] at [m inecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at org.bukkit.plugin.SimplePluginManager.disablePlugin(SimplePluginManag [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at org.bukkit.plugin.SimplePluginManager.disablePlugins(SimplePluginMana [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]

    at org.bukkit.craftbukkit.v1_7_R3.CraftServer.disablePlugins(CraftServer .java:395) [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at net.minecraft.server.v1_7_R3.MinecraftServer.stop(MinecraftServer.jav a:385) [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at :500) [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks] at 28) [minecraft_server.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]

  • Avatar of Cmoor Cmoor Mar 02, 2015 at 08:23 UTC - 0 likes

    @gpotter2: Go

    you mean a life?

  • Avatar of AstralRevenant AstralRevenant Feb 27, 2015 at 17:38 UTC - 0 likes

    A nifty plugin this one is. Great work confuserr! :-)


    Hosting a survival multiplayer minecraft server. The server address is "", (between the quotes). The client is spigot 1.8(latest). :-)

  • Avatar of ferrago ferrago Feb 24, 2015 at 15:12 UTC - 0 likes

    @SirPsp: Go

    I am having the problem of the thing never teleporting. Might be a bug with spigot's PacketPlayOutEntityTeleportEvent

    CQR|CQR BFAK:90678341,d162341bd70f9d48ee9bedc969773e3b0744d0a6da70e240520c96318ec8557b

  • Avatar of gpotter2 gpotter2 Feb 12, 2015 at 18:14 UTC - 0 likes

    @SirPsp: Go

    Known caveats
    * 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.

    Just read before downloading....

    Last edited Feb 12, 2015 by gpotter2

    Code is code, it is not pizza...



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