命令
/bossbar
创建并控制显示在玩家屏幕顶部的自定义Boss栏。
语法
| /bossbar add <id> <name> |
| /bossbar get <id> (max|players|value|visible) |
| /bossbar list |
| /bossbar remove <id> |
| /bossbar set <id> color (blue|green|pink|purple|red|white|yellow) |
| /bossbar set <id> (max <max>|name <name>|value <value>|visible <visible>) |
| /bossbar set <id> players [<targets>] |
| /bossbar set <id> style (notched_10|notched_12|notched_20|notched_6|progress) |
参数
| 参数 | 值的类型 | 输入内容 |
|---|---|---|
| <id> | ID | Boss栏带命名空间的ID，例如 example:raid。不带命名空间时，使用 minecraft:。 |
| <name> | 文本组件 | 以文本组件表示的显示名称，例如 "Raid Progress" 或 {text:"Raid Progress",color:"red"}。 |
| <max> | 整数 | 进度条的最大值。1或更大的整数。至少为1。 |
| <targets> | 目标选择器 | 应看到该栏的玩家。对于set players为可选：省略则清空列表。一名或多名玩家。 |
| <value> | 整数 | 进度条的当前值。0或更大的整数。至少为0。 |
| <visible> | 真或假 | true显示该条，false隐藏。 |
详细信息
| 权限等级 | 2：管理员、开启作弊的世界、命令方块和函数 |
| 适用于 | 开启作弊的单人游戏和多人游戏服务器。需要权限等级2（游戏管理员）：服务器管理员、开启作弊的玩家、命令方块和函数都可以执行。 |
| 结果 | 每个子命令都会报告它做了什么。数值结果：add 和 remove 返回之后存在的 Boss 栏数量，list 返回 Boss 栏数量，get value 和 get max 返回该数值，get visible 返回1或0，get players 和 set players 返回栏上的玩家数， set value 和 set max 返回新的数值，其他 set 命令返回0。 |
| add | 用给定的ID和显示名称创建一个新的Boss栏。初始值为0，最大值为100，颜色为白色，样式为 progress，可见，且没有玩家，因此在设置玩家之前没有人能看到它。如果已存在具有该 ID 的Boss栏，则失败。 |
| remove | 删除Boss栏，并将其从每名玩家的屏幕上移除。 |
| list | 列出所有自定义 Boss 栏，或说明没有任何 Boss 栏。 |
| get | 读取Boss栏的一个属性：value、max、visible或players（栏上当前在线的玩家）。 |
| set value和set max | 更改当前值和最大值。进度条按value除以max填充，如果数值大于最大值，则显示为满。最大值必须至少为1，数值必须至少为0。 |
| set color | 将进度条颜色更改为blue、green、pink、purple、red、white或yellow。 |
| set style | 更改进度条的分段方式：progress为一整条，notched_6、notched_10、notched_12和notched_20则分成相应数量的段。 |
| set name | 更改进度条上方显示的文字。 |
| set players | 替换能看到该栏的玩家列表。不带玩家参数时，会为所有人移除该条。 |
| set visible | 为其玩家显示或隐藏进度条，而不删除它。 |
| 无变化 | 如果进度条已经是该设置，每条 set 命令都会失败，并提示“没有任何更改”。任何指明Boss栏的命令，如果不存在具有该ID的Boss栏，就会失败。 |
示例
/bossbar add example:raid "Raid Progress"创建一个名为Raid Progress的Boss栏。
/bossbar set example:raid players @a向所有在线玩家显示Boss栏。
/bossbar set example:raid value 50当最大值为100时，将进度条填到一半。
/bossbar set example:raid color red将该栏变为红色。
/bossbar set example:raid style notched_10将进度条分成10段。
/bossbar remove example:raid删除Boss栏。