Boss 条

关于

Boss 条是在屏幕最上方的一条栏。它本来用于显示凋零 & 末影龙的血量，但是插件将它的作用拓宽了。在 1.9 版本 Mojang 新增了可以不需要实体就可以修改 Boss 条的包(Packet)，并且还可以修改它的颜色和风格。

启用

要启用该功能，打开 config.yml 并设置

bossbar:
  enabled: true

配置

配置 Boss 条

bossbar:
  bars:
    MyBossbar:
      style: "PROGRESS"
      color: "%animation:barcolors%"
      progress: "100"
      text: "&fWebsite: &bwww.domain.com"

每个 Boss 条拥有 4 个属性:

style（风格）

Boss 条划风的样式，仅在 1.9+ 以上版本提供。 你可以选择 5 种风格: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 和 NOTCHED_20 这是由 Mojang 固定提供的，没有其他的选项可以选择。其他使用 Bukkit API 的 Boss 条插件可能只是名字不一样，但它们的原理和 TAB 一样。所以你不必为求“自定义风格"的BOSS条插件而到处寻找。

color（颜色）

Boss 条的颜色，仅在 1.9+ 以上版本提供。旧版本将只会看到 PINK 色。 你可以选择 7 种颜色: BLUE, GREEN, PINK, PURPLE, RED, WHITE 和 YELLOW 这是由 Mojang 固定提供的，没有其他的选项可以选择。

progress（百分比）

从 0 到 100 数字，支持小数。大于 100 的数字将会导致显示错误。 如果你想要显示一个变量符的值的进度，那么你可以使用来自 PlaceholderAPI 的 Math Expansion 并设置这样的变量符: %math_{变量符当前的值}/{变量符最大的值}*100% 或者 %math_{变量符当前的值}/<变量符最大的值>*100% 这样你的最大值就可以固定为 100 了。

注意: 将上面文本的 {} 符号内替换你真正需要的变量符（你不能在 math 变量符中再套娃 %placeholder% 样式的变量符，因此需要这个符号代替原来的 % 符号），将 <变量符最大的值> 替换为一个正整数。（例如20）

展示玩家血量的示例: %math_{player_health}/20*100% 或者 %math_{player_health}/{player_max_health}*100%。

text（文本）

Boss 条的文本。长度是没有限制的，支持 1.16+ 的 RGB 代码。不支持换行。

所有 4 种属性都支持变量符。这也包括动画，可以用于改变 Boss 条的文本或者缓慢出现特效。

在下面的示例中，Boss条的文本将会在我们在动画中添加的四个文本之间切换: animations.yml

bossbarText:
  change-interval: 10000
  texts:
    - "&avote.domain.com"
    - "&a&nvote.domain.com"
    - "&5vote.domain.com"
    - "&5&nvote.domain.com"

config.yml

bossbar:
  bars:
    MyBossbar:
      style: "PROGRESS"
      color: "BLUE"
      progress: "100"
      text: "%animation:bossbarText%"
      announcement-bar: false

你也可以使用一些代表等级的变量符来使得 Boss 条看起来更加炫酷，取决于你。

announcement-bar

当设置成 true，Boss 条默认将不会显示，这一般代表这个 Boss 条用于公告。

bossbar:
  bars:
    MyBossbar:
      style: "PROGRESS"
      color: "BLUE"
      progress: "100"
      text: "Text"
      announcement-bar: true #false or undefined means it will be visible all the time

display-condition

玩家看到此 Boss 条必须满足的 条件。公告（见下）出的 Boss 条同样需要检查玩家是否满足条件，玩家必须满足条件才会看到 Boss 条。当 Boss 条没有设置条件时，它会无条件的向所有玩家展示。

bossbar:
  bars:
    MyBossbar:
      style: "PROGRESS"
      color: "BLUE"
      progress: "100"
      text: "This bossbar is only visible in world 'world'"
      display-condition: "%world%=world"

公告指令

/tab announce bar <name> <time> name 是 bossbar.yml 文件内的 Boss条名称， time 是显示的时长。

当使用 Boss 条公告时，你将拥有一个新的变量符可以使用: %countdown% 它将显示该公告显示的剩余时间。

额外设置

toggle-command: /bossbar

玩家开关 Boss 条的指令。玩家需要 tab.bossbar.toggle 权限才能使用它。 注意: 这个指令不会在指令自动补充框中出现，因为它不是一个真正注册的指令。注册的指令必须在插件中就已经决定好，不能动态修改。如果你想要解决这个问题，请自行定制插件。

remember-toggle-choice: false 如果启用，切换计分板的指令偏好将会保存。玩家在重新加入、服务器重启等后依然保留该偏好。

hidden-by-default: false 当启用后，Boss 条默认不显示，只有使用指令才会让其显示。

在指定世界、服务器禁用

bossbar:
  disable-in-worlds:
    - disabledworld
  disable-in-servers:
    - disabledserver

要在除了所列的世界外禁用，只需添加 WHITELIST 关键词到列表中，这回导致该功能只会在所列的世界中启用。示例：

bossbar:
  disable-in-worlds:
    - WHITELIST
    - enabledworld

注意: 在指定服务器关闭只能在 BungeeCord 上使用，并且还需安装 TAB-Bridge 插件到所有子服上。

在 <1.9 上的限制

• 如果 TAB 安装在 BungeeCord 上，则 Boss 条不会发送给玩家。

• 不提供选择颜色和风格功能。

• 如果进度条在 50% 及以下则会在显示方面有问题。(客户端bug)

• 同一时间只能显示一行。

• 如果你不在客户端关闭粒子效果显示，则会有雾效果。(仿佛在打BOSS)

• 在看着方块的时候可能不会显示。

额外信息

额外信息 1 - 隐藏 Boss 条的条

如果您想要隐藏 Boss条 本身而不包括它显示的文本，这是可能的，但不是从插件层面。你需要自己使用资源包来隐藏 Boss条，然后强制你的玩家使用该资源包。

笔者在另外一个教程 ItemsAdder 使用教程 对此有详细介绍，欢迎参考。