Class ActionBar
Action bars are text messages that appear above the player's hotbar Note that this is different from the text appeared when switching between items. Those messages show the item's name and are different from action bars. The only natural way of displaying action bars is when mounting.
Action bars cannot fade or stay like titles. For static Action bars you'll need to send the packet every 2 seconds (40 ticks) for it to stay on the screen without fading.
PacketPlayOutTitle: https://wiki.vg/Protocol#Title
- Version:
- 4.0.0
- Author:
- Crypto Morin
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionstatic void
clearActionBar
(org.bukkit.entity.Player player) Clear the action bar by sending an empty message.static void
Clear the action bar by sending an empty message to all the online players.static void
sendActionBar
(org.bukkit.entity.Player player, String message) Sends an action bar to a player.static void
sendActionBar
(org.bukkit.plugin.Plugin plugin, org.bukkit.entity.Player player, String message) Sends an action bar to a player.static void
sendActionBar
(org.bukkit.plugin.Plugin plugin, org.bukkit.entity.Player player, String message, long duration) Sends an action bar to a player for a specific amount of ticks.static void
sendActionBarWhile
(org.bukkit.plugin.Plugin plugin, org.bukkit.entity.Player player, String message, Callable<Boolean> callable) Sends an action bar to a player for a specific amount of ticks.static void
sendActionBarWhile
(org.bukkit.plugin.Plugin plugin, org.bukkit.entity.Player player, Callable<String> message, Callable<Boolean> callable) Sends an action bar to a player for a specific amount of ticks.static void
sendPlayersActionBar
(String message) Sends an action bar all the online players.
-
Method Details
-
sendActionBar
public static void sendActionBar(@Nonnull org.bukkit.plugin.Plugin plugin, @Nonnull org.bukkit.entity.Player player, @Nullable String message) Sends an action bar to a player. This particular method supports a special prefix for configuring the time of the actionbar.Format:
^number|
wherenumber
is in seconds.
E.g.^7|&2Hello &4World!
will keep the actionbar active for 7 seconds.- Parameters:
player
- the player to send the action bar to.message
- the message to send.- Since:
- 3.2.0
- See Also:
-
sendActionBar
public static void sendActionBar(@Nonnull org.bukkit.entity.Player player, @Nullable String message) Sends an action bar to a player.- Parameters:
player
- the player to send the action bar to.message
- the message to send.- Since:
- 1.0.0
- See Also:
-
sendActionBar
public static void sendActionBar(@Nonnull org.bukkit.plugin.Plugin plugin, @Nonnull org.bukkit.entity.Player player, @Nullable String message, long duration) Sends an action bar to a player for a specific amount of ticks.- Parameters:
plugin
- the plugin handling the message scheduler.player
- the player to send the action bar to.message
- the message to send.duration
- the duration to keep the action bar in ticks.- Since:
- 1.0.0
- See Also:
-
sendPlayersActionBar
Sends an action bar all the online players.- Parameters:
message
- the message to send.- Since:
- 1.0.0
- See Also:
-
clearActionBar
Clear the action bar by sending an empty message.- Parameters:
player
- the player to send the action bar to.- Since:
- 2.1.1
- See Also:
-
clearPlayersActionBar
public static void clearPlayersActionBar()Clear the action bar by sending an empty message to all the online players.- Since:
- 2.1.1
- See Also:
-
sendActionBarWhile
public static void sendActionBarWhile(@Nonnull org.bukkit.plugin.Plugin plugin, @Nonnull org.bukkit.entity.Player player, @Nullable String message, @Nonnull Callable<Boolean> callable) Sends an action bar to a player for a specific amount of ticks. Plugin instance should be changed in this method for the schedulers.If the caller returns true, the action bar will continue. If the caller returns false, action bar will not be sent anymore.
- Parameters:
plugin
- the plugin handling the message scheduler.player
- the player to send the action bar to.message
- the message to send. The message will not be updated.callable
- the condition for the action bar to continue.- Since:
- 1.0.0
- See Also:
-
sendActionBarWhile
public static void sendActionBarWhile(@Nonnull org.bukkit.plugin.Plugin plugin, @Nonnull org.bukkit.entity.Player player, @Nullable Callable<String> message, @Nonnull Callable<Boolean> callable) Sends an action bar to a player for a specific amount of ticks.If the caller returns true, the action bar will continue. If the caller returns false, action bar will not be sent anymore.
- Parameters:
plugin
- the plugin handling the message scheduler.player
- the player to send the action bar to.message
- the message to send. The message will be updated.callable
- the condition for the action bar to continue.- Since:
- 1.0.0
- See Also:
-