Commands/bossbar
< Commands
This feature is exclusive to Java Edition.
bossbar
| Restrictions |
|---|
Creates and modifies boss bars.
Contents
Syntax[edit]
bossbar add <id> <name>- Create a new boss bar.
bossbar get <id> (max|players|value|visible)- Return the requested setting as a
resultof the command.
- Return the requested setting as a
bossbar list- Display a list of existing boss bars.
bossbar remove <id>- Remove an existing bossbar.
bossbar set <id> (color|max|name|players|style|value|visible)... color (blue|green|pink|purple|red|white|yellow)- Set the text color (if no color was specified as part of a text component) and bar color. Defaults to
whiteupon creation.
- Set the text color (if no color was specified as part of a text component) and bar color. Defaults to
... max <max>- Set the boss bar's maximum value. Defaults to
100upon creation.
- Set the boss bar's maximum value. Defaults to
... name <name>- Set the boss bar's name.
... players [<targets>]- Change the set of players to whom the bar is visible. Defaults to none upon creation.
... style (notched_6|notched_10|notched_12|notched_20|progress)- Set the boss bar's visual amount of segments: continuous, 6 segments, 10 segments, 12 segments, or 20 segments. Defaults to
progressupon creation.
- Set the boss bar's visual amount of segments: continuous, 6 segments, 10 segments, 12 segments, or 20 segments. Defaults to
... value <value>- Set the boss bar's current value. Defaults to
0upon creation.
- Set the boss bar's current value. Defaults to
... visible <visible>- Set the boss bar's visibility. Defaults to
trueupon creation.
- Set the boss bar's visibility. Defaults to
Arguments[edit]
<id>: resource_location
- Must be a namespaced ID.
- Specifies a unique boss bar.
<name>: component
- Must be a raw JSON text.
- Specifies the display name of the boss bar.
<max>: integer
- Must be a 32-bit integer number. And it must be between 1 and 2147483647 (inclusive).
- Specifies the boss bar's maximum value.
<targets>: entity
- Must be a player name, a target selector or a UUID. And the target selector must be of player type.
- Specifies the set of players to whom the bar is visible
<value>: integer
- Must be a 32-bit integer number. And it must be between 0 and 2147483647 (inclusive).
- Specifies the boss bar's current value.
<visible>: bool
- Must be a boolean (either
trueorfalse). - Specifies the boss bar's visibility.
Result[edit]
| Command | Trigger | Java Edition |
|---|---|---|
| any | the arguments are not specified correctly | Unparseable |
/bossbar set ... | if specified boss bar doesn't exist | Failed |
/bossbar add ... | if a boss bar with specified id have already existed | |
/bossbar set ... | if the boss bar's property have already been the same as the specified value | |
| any | On success | Creates, modifies or lists boss bar(s). |
Output[edit]
| Command | Edition | Situation | Success Count | /execute store succeess ... | /execute store result ... |
|---|---|---|---|---|---|
| any | Java Edition | On fail | 0 | 0 | 0 |
/bossbar add ... | On success | 1 | 1 | The number of custom bosbars that exist after the command is executed. Bosbars created by the game (such as the boss bar of the ender dragon) isn't included. | |
/bossbar get <id> max | On success | 1 | 1 | The boss bar's maximum value after the command is executed. | |
/bossbar get <id> value | On success | 1 | 1 | The boss bar's value after the command is executed. | |
/bossbar get <id> players | On success | 1 | 1 | The number of players to whom the bar is visible after the command is executed. | |
/bossbar get <id> visible | On success | 1 | 1 | 1 if the boss bar is visible; otherwise 0. | |
/bossbar set <id> color | On success | 1 | 1 | 0 |
History[edit]
| Java Edition | |||||
|---|---|---|---|---|---|
| 1.13 | 18w05a | Added bossbar | |||
