/bossbar 命令
来源：Commands/bossbar，英文修订 ID：3834896。
此条目描述命令；HUD 元素见 Bossbar。此命令仅适用于 Java 版，所需权限等级为 2。
创建、修改和列出 Boss 栏。
语法
bossbar add <id> <name>：创建新 Boss 栏，保存在level.dat的CustomBossEvents中。bossbar get <id> (max|players|value|visible)：把指定设置作为命令的 result 值返回。bossbar list：显示现有 Boss 栏列表。bossbar remove <id>：移除已有 Boss 栏。bossbar set <id> (color|max|name|players|style|value|visible)：设置下列属性。
set 子命令 |
功能与初始默认值 |
|---|---|
... color (blue|green|pink|purple|red|white|yellow) |
设置栏颜色，以及文字组件未指定颜色时的文字颜色；默认 white |
... max <max> |
设置最大值；默认 100 |
... name <name> |
设置名称 |
... players [<targets>] |
更改可看到栏的玩家集合；初始不对任何玩家显示 |
... style (notched_6|notched_10|notched_12|notched_20|progress) |
设置为连续栏或 6、10、12、20 段；默认 progress |
... value <value> |
设置当前值；默认 0 |
... visible <visible> |
设置是否可见；默认 true |
参数
<id>: resource_location：指定唯一 Boss 栏的资源位置。
<name>: component：指定 Boss 栏的显示名称，必须为有效的文字组件。
<max>: integer：Boss 栏最大值，必须为至少 1 的 32 位整数。
<targets>: entity：可看到栏的一组玩家。省略时不对任何玩家显示。必须为玩家名称、目标选择器或 UUID，且选择器必须为玩家类型。
<value>: integer：当前值，必须为至少 0 的 32 位整数。
<visible>: bool：是否可见，必须为 true 或 false。
结果
命令不完整或任一参数指定错误时无法解析。下列情况失败：
set、remove或get指定的 Boss 栏不存在。add指定的 ID 已存在。set设置的属性与当前值相同。
其他情况成功。
输出
失败时成功次数、success 和 result 均为 0。成功时成功次数与 success 均为 1，result 取决于子命令：
| 子命令 | result |
|---|---|
add、list、remove |
执行后存在的自定义 Boss 栏数量；不计游戏自身创建的栏，例如末影龙 Boss 栏 |
get <id> max、set <id> max |
执行后的最大值 |
get <id> value、set <id> value |
执行后的当前值 |
get <id> players、set <id> players |
执行后可看到此栏的玩家数量 |
get <id> visible |
可见时为 1，否则为 0 |
set <id> color/name/style/visible |
0 |
本文为 Minecraft Wiki 对应英文条目的中文翻译与改编，已按要求省略变更历史。原作者与贡献者见来源页及其历史；除另有说明外，按 CC BY-NC-SA 3.0 非商业、署名、相同方式共享。