此特性为Java版独有。
bossbar
需要的权限等级 | 2 |
---|---|
限制条件 | 无 |
用于创建或修改Boss栏。
语法
bossbar add <id> <name>
bossbar get <id> (max|players|value|visible)
bossbar list
bossbar remove <id>
bossbar set <id> (color|max|name|players|style|value|visible)
... color (blue|green|pink|purple|red|white|yellow)
... max <max>
... name <name>
... players [<targets>]
... style (notched_6|notched_10|notched_12|notched_20|progress)
... value <value>
... visible <visible>
参数
<id>
:resource_location
- 指定一个Boss栏,使用命名空间ID格式。如果未设置命名空间,默认为
minecraft:
。 - 必须为命名空间ID。
name
- Boss栏的名字,必须为有效的原始JSON文本格式。
... add <id> <name>
- 创建一个新的Boss栏。
... get <id> (max|players|value|visible)
- 返回请求的指定设置。
... list
- 显示现存的Boss栏列表。
... remove <id>
- 移除一个现存的Boss栏。
... set <id> (color|max|name|players|style|value|visible)
... color (blue|green|pink|purple|red|white|yellow)
- 设置Boss栏内容的颜色和名称(如果名称的JSON文本中没有指定颜色)的颜色。
- 默认为
white
(白色)。
<max>
:integer- 设置Boss栏的最大值。
- 默认为
100
。 - 必须为32位整型数值。且必须在1和2147483647(含)之间。
<name>
:component- 设置Boss栏的名称。
- 必须为原始JSON文本。
<targets>
:entity- 设置哪些玩家可以看见Boss栏。
- 默认为没有玩家。
- 缺省此项以设置为没有玩家
- 必须为玩家名、目标选择器或UUID。且目标选择器只允许玩家。
(progress|notched_6|notched_10|notched_12|notched_20)
- 设置Boss栏在视觉上分成几段:连续、6段、10段、12段或20段。
- 默认为
progress
(连续)。
<value>
:integer- 设置Boss栏的当前值。
- 默认为
0
。 - 必须为32位整型数值。且必须在0和2147483647(含)之间。
<visible>
:bool- 设置Boss栏是否可见。
- 默认为
true
。 - 必须为布尔值(
true
或false
)。
效果
命令 | 触发条件 | Java版 |
---|---|---|
任意 | 参数不正确 | 无法解析 |
/bossbar set ... |
指定的Boss栏不存在 | 执行失败 |
/bossbar add ... |
已有相同ID的Boss栏 | |
/bossbar set ... |
尝试设定时指定值与原值相同 | |
任意 | 执行成功时 | 创建、修改、列出或移除Boss栏 |
输出
命令 | 版本 | 条件 | 成功次数 | /execute store success ... |
/execute store result ... |
---|---|---|---|---|---|
任意 | Java版 | 执行失败 | 0 | 0 | 0 |
/bossbar add ... |
执行成功 | 1 | 1 | 命令执行后存在的自定义Boss栏数量 注意游戏本身的Boss栏,(如末影龙的)不计入其中。 |
|
/bossbar get <id> max |
执行成功 | 1 | 1 | 命令执行后指定Boss栏的最大值。 | |
/bossbar get <id> value |
执行成功 | 1 | 1 | 命令执行后指定Boss栏的值。 | |
/bossbar get <id> players |
执行成功 | 1 | 1 | 命令执行后可以见到该Boss栏的玩家数。 | |
/bossbar get <id> visible |
执行成功 | 1 | 1 | 若该Boss栏可见,输出1,否则输出0。 | |
/bossbar set <id> color |
执行成功 | 1 | 1 | 0 |