BarAPI

BarAPI

Server Owners

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

Developers

Simply add BarAPI.jar to your project build path.

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

Limitations

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.

Examples

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.

Tutorials

German - DerFeliix

Source

GitHub

Maven

<repositories>
	<repository>
		<id>confuser-repo</id>
		<url>http://ci.frostcast.net/plugin/repository/everything</url>
	</repository>
</repositories>

<dependencies>
	<dependency>
		<groupId>me.confuser</groupId>
		<artifactId>BarAPI</artifactId>
		<version>3.0</version>
	</dependency>
</dependencies>

Developer Builds

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

Frostcast CI

Updater

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

WelcomeBar

Parkour

QuickSupport

BossBroadcast

BossMessage

PvPGames Automated

BossEventScheduler

Infernal Mobs

MythicMobs

MultiKill

PlayerBoss

BossAds

Item Lore Stats

BossBarPro

VIPLobby

Battle Of Blocks

BossBroadcaster

SilkSpawners

BarJoin

JoinGlobalMessages

Metrics

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 Sep 30, 2014 at 09:45 UTC - 1 like

    @thexenon05: Go

    useSpigotHack should be true

    @DanSpedey: Go

    Possibly, depends what we'll use over at Frostcast.

  • Avatar of thexenon05 thexenon05 Sep 28, 2014 at 18:34 UTC - 0 likes

    I'm getting this error: http://pastebin.com/rjq5yzS0 My config: autoUpdate>False, testMode>False, useSpigotHack>False.

    I'm using Spigot Patched 27. Please help me, I really need this plugin working... :C

  • Avatar of vemacs vemacs Sep 28, 2014 at 18:09 UTC - 0 likes

    Repo with proper 1.8 support (wither for 1.8, dragon for 1.7, continously teleported wither): https://github.com/confuser/BarAPI/issues/37

  • Avatar of DanSpedey DanSpedey Sep 28, 2014 at 15:52 UTC - 0 likes

    Will the plugin be ported to Sponge?

    http://i.imgur.com/UjXiBGT.gif

  • Avatar of gnaxi gnaxi Sep 26, 2014 at 20:02 UTC - 0 likes

    The builds page seems to be down. Any update on when it will be back up?

  • Avatar of AragurLp AragurLp Sep 25, 2014 at 18:16 UTC - 0 likes

    @confuserr: Go

    And how can I donwload a specialiced build?

  • Avatar of confuserr confuserr Sep 25, 2014 at 13:29 UTC - 0 likes

    @iaXedu: Go

    If you're on #1649 of spigot, use build 26.

    If you are running spigot #1649 with the patches, use builds 27 and up.

  • Avatar of Nickx000x Nickx000x Sep 25, 2014 at 00:43 UTC - 0 likes

    @Jalau: Go

    Some servers, like the Hypixel Network, send wither entity packets to the player with the specified name (boss bar message) and teleports it to the player's line of sight, and stays the same position away from the player when they move. I would also like to mention that its not directly in the line of sight, it has an offset, but still works perfectly, so it can be a less of a distraction. This seems like a horrible idea, since player's can see the wither, but in 1.8 I am pretty sure u can only see bossbars when they are in line of sight :( so sad.

  • Avatar of apesgrapes apesgrapes Sep 24, 2014 at 19:55 UTC - 0 likes

    @confuserr: Go

    thanks, my mistake. despite all that error text pointing at BarAPI it was BossBarMessage creating the error (when the /bm command is autoran at player join/death). without that plugin loaded there are no errors.

  • Avatar of iaXedu iaXedu Sep 24, 2014 at 14:29 UTC - 0 likes

    http://pastebin.com/Pu2QCcFr

    Spigot-1.7.9-R0.2-205-g48578ee Latest DEV on your jenkins.

    With the following settings: autoUpdate: false testMode: false useSpigotHack: true

    https://minestatus.net/53334-guildcraft/image/original.png

Facts

Date created
Sep 01, 2013
Category
Last update
Apr 19, 2014
Development stage
Release
License
Creative Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales
Curse link
BarAPI
Downloads
306,884
Recent files

Authors