BarAPI

Table of Contents

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

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.

Comments

_ForgeUser9681813
- Join Date: 9/24/2012
- Posts: 35
- Member Details
#224 _ForgeUser9681813

View User Profile

Send Message

Posted Sep 2, 2014
@confuser

Just for helping, I already found the reason why it isn't working: In spigot(dunno about bukkit) there was a field added onGround, this fixed it: public Object getTeleportPacket(Location loc) { .... packet = PacketPlayOutEntityTeleport.getDeclaredConstructor(new Class<?>[] { int.class, int.class, int.class, int.class, byte.class, byte.class, boolean.class }).newInstance(this.id, loc.getBlockX() * 32, loc.getBlockY() * 32, loc.getBlockZ() * 32, (byte) ((int) loc.getYaw() * 256 / 360), (byte) ((int) loc.getPitch() * 256 / 360), true);

And: public Object getTeleportPacket(Location loc) { ..... Field onGround = Util.getField(packet_class, "onGround"); onGround.setAccessible(true); onGround.set(packet, true);

onGround false does remove the error but the Enderdragon still disapears on teleport so i used true and it worked :)

Edit: Problem is, 1.7.8 etc clients can see the bar, 1.8 clients can't :D

Last edited by _ForgeUser9681813: Sep 2, 2014

Rollback Post to Revision RollBack
realconfuser
- Join Date: 12/23/2011
- Posts: 594
- Member Details
#223 realconfuser

View User Profile

Send Message

Posted Sep 2, 2014
@parat26ify

This plugin is an API for other developers to implement. There are NO commands. Go complain to the plugin developer about the errors you are experiencing, as they have nothing to do with this plugin.

@Squawkers13

Yep, will do, just converting Frostcast over to the 1.8 hack first, then I'll sort it out those errors with this plugin :)

Rollback Post to Revision RollBack
_ForgeUser7446286
- Join Date: 8/26/2011
- Posts: 19
- Member Details
#222 _ForgeUser7446286

View User Profile

Send Message

Posted Sep 2, 2014
Are you guys really serious? I have really no clue how these commands work, the message bar disappears after the seconds if you set it permanently, and the fun part, it seems like there is no command check which means it throws an ArrayOutOfBoundsException if you don't specify enough arguments. Also, all the commands seem to work exactly the same, no matter if its /bm world or just /bm, it's just really confusing.

Last edited by _ForgeUser7446286: Sep 2, 2014

Rollback Post to Revision RollBack

_ForgeUser10909230

Join Date: 4/6/2013
Posts: 357
Member Details

#221 Posted Sep 1, 2014

Could you possibly add compatibility with Spigot's 1.8 protocol hack?

Running API methods on a Spigot 1.8 protocol supporting server throws this error:

[20:47:34 WARN]: java.lang.NoSuchMethodException: net.minecraft.server.v1_7_R4.P
acketPlayOutEntityTeleport.<init>(int, int, int, int, byte, byte)
[20:47:34 WARN]:        at java.lang.Class.getConstructor0(Unknown Source)
[20:47:34 WARN]:        at java.lang.Class.getConstructor(Unknown Source)
[20:47:34 WARN]:        at me.confuser.barapi.nms.v1_7.getTeleportPacket(v1_7.ja
va:139)
[20:47:34 WARN]:        at me.confuser.barapi.BarAPI.sendDragon(BarAPI.java:410)

[20:47:34 WARN]:        at me.confuser.barapi.BarAPI.setHealth(BarAPI.java:359)
[20:47:34 WARN]:        at net.pekkit.bossbroadcaster.BroadcastManager.updateBar
(BroadcastManager.java:47)
[20:47:34 WARN]:        at net.pekkit.bossbroadcaster.BroadcastManager.access$30
0(BroadcastManager.java:15)
[20:47:34 WARN]:        at net.pekkit.bossbroadcaster.BroadcastManager$TaskPerce
ntage.run(BroadcastManager.java:114)
[20:47:34 WARN]:        at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftTask.ru
n(CraftTask.java:71)
[20:47:34 WARN]:        at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftSchedul
er.mainThreadHeartbeat(CraftScheduler.java:350)
[20:47:34 WARN]:        at net.minecraft.server.v1_7_R4.MinecraftServer.v(Minecr
aftServer.java:641)
[20:47:34 WARN]:        at net.minecraft.server.v1_7_R4.DedicatedServer.v(Dedica
tedServer.java:289)
[20:47:34 WARN]:        at net.minecraft.server.v1_7_R4.MinecraftServer.u(Minecr
aftServer.java:584)
[20:47:34 WARN]:        at net.minecraft.server.v1_7_R4.MinecraftServer.run(Mine
craftServer.java:490)
[20:47:34 WARN]:        at net.minecraft.server.v1_7_R4.ThreadServerApplication.
run(SourceFile:628)

realconfuser
- Join Date: 12/23/2011
- Posts: 594
- Member Details
#220 realconfuser

View User Profile

Send Message

Posted Aug 17, 2014
Just tested v3.1 with 1.7.10 and it seemed to work just fine.

Those that experienced errors, what build did you have the problem with?

Rollback Post to Revision RollBack
WoutWoot
- Location: woutwoot
- Join Date: 8/28/2011
- Posts: 287
- Member Details
#219 WoutWoot

View User Profile

Send Message

Posted Aug 14, 2014
I've recompiled this plugin with 1.7.10 and java 1.7 and it seems to work. However THIS BUILD IS NOT REVIEWED BY BUKKIT (So basically I could make it destroy your server, it won't, but just have to tell you that) http://wwx.be:8283/job/BarAPI/ You can see everything I've changed here: https://github.com/woutwoot/BarAPI

Rollback Post to Revision RollBack
timbru31
- Join Date: 8/31/2011
- Posts: 1,045
- Member Details
#218 timbru31

View User Profile

Send Message

Posted Aug 13, 2014
Pssst, SilkSpawners does use BarAPI, too :)

Rollback Post to Revision RollBack
realconfuser
- Join Date: 12/23/2011
- Posts: 594
- Member Details
#217 realconfuser

View User Profile

Send Message

Posted Aug 11, 2014
@frickx

I'll take a look at the weekend.

Rollback Post to Revision RollBack
_ForgeUser10177576
- Join Date: 12/7/2012
- Posts: 42
- Member Details
#216 _ForgeUser10177576

View User Profile

Send Message

Posted Aug 9, 2014
Please update to 1.7.10. :)

Rollback Post to Revision RollBack
Forge_User_91169793
- Join Date: 10/30/2009
- Posts: 1
- Member Details
#215 Forge_User_91169793

View User Profile

Send Message

Posted Aug 7, 2014
seems that it doesnt work with spigot 1.7.10 :/

Caused by: java.lang.NullPointerException
   at me.confuser.barapi.Util.sendPacket(Util.java:71) ~[?:?]
   at me.confuser.barapi.BarAPI.addDragon(BarAPI.java:423) ~[?:?]
   at me.confuser.barapi.BarAPI.getDragon(BarAPI.java:417) ~[?:?]
   at me.confuser.barapi.BarAPI.setMessage(BarAPI.java:279) ~[?:?]

Also not with craftbukkit-1.7.9-R0.2

Last edited by Forge_User_91169793: Aug 7, 2014

Rollback Post to Revision RollBack
realconfuser
- Join Date: 12/23/2011
- Posts: 594
- Member Details
#214 realconfuser

View User Profile

Send Message

Posted Aug 7, 2014
@kevc45

You need the plugin on your server. The maven dependency is simply for building your plugin. Also, why are you using 3.0 when 3.1 is the latest?

Rollback Post to Revision RollBack
StarlightGaze
- Join Date: 2/19/2012
- Posts: 21
- Member Details
#213 StarlightGaze

View User Profile

Send Message

Posted Aug 6, 2014
Hey, the BarAPI 3.0 maven dependency seems to be broken. Because when I just include the downloaded jar from dev.bukkit it works.

Here is the error I get: "This server is running CraftBukkit version git-Bukkit-1.7.2-R0.3-66-g43d8943-b3078jnks (MC: 1.7.9) (Implementing API version 1.7.9-R0.1-SNAPSHOT) Ambiguous plugin name `BarAPI' for files `plugins\PluginName-1.0.jar' and `plugins\BarAPI.jar' in `plugins'" Also my plugin does not enable.

Rollback Post to Revision RollBack
madtomic
- Location: Rehoboth Beach
- Join Date: 3/29/2014
- Posts: 1,204
- Member Details
#212 madtomic

View User Profile

Send Message

Posted Jul 29, 2014
any permissions for this plugin?

Rollback Post to Revision RollBack
Forge_User_72287062
- Join Date: 3/23/2013
- Posts: 163
- Member Details
#211 Forge_User_72287062

View User Profile

Send Message

Posted Jul 27, 2014
@Lionhard98

Add a check if the percentage you set the boss bar to, is (lower than) 0. If so, set it to 1. =)

Rollback Post to Revision RollBack
rizzywthablizzy
- Location: Minecraft
- Join Date: 2/17/2014
- Posts: 23
- Member Details
#209 rizzywthablizzy

View User Profile

Send Message

Posted Jul 17, 2014
@Condolent

No its just like when you use craftbukkit on your build path. It is just there so the program you use knows what you are talking about, which is why you needed to add it to the server.

Rollback Post to Revision RollBack
_ForgeUser7138555
- Join Date: 7/4/2011
- Posts: 52
- Member Details
#208 _ForgeUser7138555

View User Profile

Send Message

Posted Jul 15, 2014
It only works if the .jar file is in my plugins folder on the server. Shouldn't it just be needed to add it to my buildpath?

Last edited by _ForgeUser7138555: Jul 15, 2014

Rollback Post to Revision RollBack
_ForgeUser14087811
- Join Date: 4/14/2014
- Posts: 16
- Member Details
#207 _ForgeUser14087811

View User Profile

Send Message

Posted Jul 9, 2014
Could you add my plugin to your list of plugins using the API, http://dev.bukkit.org/bukkit-plugins/draw-my-thing

Thanks ;)

Rollback Post to Revision RollBack
realconfuser
- Join Date: 12/23/2011
- Posts: 594
- Member Details
#206 realconfuser

View User Profile

Send Message

Posted Jul 2, 2014
@kup18

It's not compatible with 1.5.2, only 1.6.4+.

Rollback Post to Revision RollBack
_ForgeUser16100330
- Join Date: 6/30/2014
- Posts: 6
- Member Details
#205 _ForgeUser16100330

View User Profile

Send Message

Posted Jul 1, 2014
whne i write bm and messige it crushes and my mc server version is 1.5.2 help me plz

Rollback Post to Revision RollBack
_ForgeUser16100330
- Join Date: 6/30/2014
- Posts: 6
- Member Details
#204 _ForgeUser16100330

View User Profile

Send Message

Posted Jul 1, 2014
which version of this plugin do i need for 1.5.2 mc server?

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

64876
Created

Sep 1, 2013
Last Released File

Nov 4, 2016
Total Downloads

2,170,885
License

Creative Commons Attribution-N...

Bukkit

BarAPI

Bukkit Plugins

BarAPI

Table of Contents

BarAPI

Server Owners

Developers

Limitations

Examples

BarAPI.setMessage(Player player, String message)

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

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

BarAPI.hasBar(Player player)

BarAPI.removeBar(Player player)

BarAPI.setHealth(Player player, float percent)

Tutorials

Source

Maven

Developer Builds

Updater

To Dos

Plugins Using BarAPI

Metrics

Comments

About This Project

Categories

Members

Recent Files

Bukkit