# 计分板

## 关于

带有 SIDEBAR（侧边栏） 显示槽的计分板目标。

## 启用

打开 **config.yml** 并找到这一部分

```
scoreboard:
  enabled: false
  toggle-command: /sb
  remember-toggle-choice: false
  hidden-by-default: false
  use-numbers: false
  static-number: 0
  delay-on-join-milliseconds: 0
  respect-other-plugins: true
  disable-in-worlds: 
    - disabledworld
```

要启用该功能，请设置

```
scoreboard:
  enabled: true
```

## 创建一个计分板

计分板可以在配置文件的 `scoreboards` 部分设置。你可以创建无限多的计分板。每个计分板可以有一个条件要求，玩家必须满足条件要求才能看到计分板。如果没有满足，下一个配置的计分板将会被继续检查，以此类推。如果最后一个计分板玩家仍不满足条件，那么玩家将不会看到计分板。

每个计分板可以由 3 个部分组成。:

### title

计分板的标题。

### lines

最大 15 行文本。你也可以配置更多，但是客户端不会显示。

**注意:** 空白行将会被隐藏。如果你想要计分板的一行不显示任何内容，请使用 `" "` 。

### display-condition

一个要显示该计分板必须满足的条件。如果玩家没有满足，将会检查下一个计分板。 

## 规则

在配置超过 1 个计分板后，插件将会根据条件要求为玩家显示计分板。每个计分板的条件要求将会配置的从上到下依次检查，直到玩家能够满足的第一个计分板。总而言之，插件将会直接跳过玩家不满足的计分板，直到第一个满足的计分板。如果没有计分板满足，那么没有计分板会被显示。

## 公告指令

公告的计分板将会覆盖原来的计分板，当公告结束后，原来的计分板将会恢复。\
`/tab announce scoreboard <name> <time>`\
name - 公告计分板的名称。\
time - 公告计分板显示的时间，以秒为单位。

## 附加设置

### 开关计分板

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

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

`hidden-by-default: false`\
如果启用，记分牌将在加入时自动隐藏，直到使用切换命令显示它。

### 数字

`use-numbers: false`\
如果启用，将会在计分板左侧显示 1-15 数字，如果禁用，将会显示 `static-number` 的数字。

`static-number: 0`\
如果 use-numbers 禁用，所有行都会显示该数字。

### 其他

`delay-on-join-milliseconds: 0`\
在玩家加入服务器多久后显示计分板，以毫秒为单位。

`respect-other-plugins: true`\
如果启用，其他插件如果发送计分板，TAB会自动隐藏自己的计分板，这样其他插件的计分板就可以正常显示了。

## 在指定世界、服务器禁用

```
scoreboard:
  disable-in-worlds:
    - disabledworld
  disable-in-servers:
    - disabledserver
```

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

```
scoreboard:
  disable-in-worlds:
    - WHITELIST
    - enabledworld
```

**注意**: 在指定服务器关闭只能在 BungeeCord 上使用，并且还需安装 [TAB-Bridge](https://www.mc-market.org/resources/21641) 插件到所有子服上。

## 限制

* 在 1.13 以下版本，计分板的标题限制在 32 个字符以内(包括颜色代码)。
* 在 1.13 以下版本，计分板每行限制在 26 个字符以内(包括颜色代码)。
* 最多只能显示 15 行。
* 计分板右侧的红色数字在插件层面无法删除，你需要额外安装 Mod。（PS: 资源包也可以)

## 示例

### 示例 1 - 分世界计分板

我们将会根据 "等于号" (=) 的条件判别来检查 `%world%` 变量符。如果条件符合（即世界为你设置的世界），在指定世界的计分板将会显示给玩家。如果没有，那么会继续检查下一个计分板。如果没有计分板符合要求，那么将会显示 default（默认）计分板。

```
scoreboard:
  scoreboards:
    # start
    scoreboard1:
      display-condition: "%world%=world1"
      title: 'Scoreboard 1'
      lines:
      - 'You are in world world1'
    # first condition didn't pass, try next
    scoreboard2:
      display-condition: "%world%=world2"
      title: 'Scoreboard 2'
      lines:
      - 'You are in world world2'
    # first two conditions didn't pass, try next
    scoreboard3:
      display-condition: "%world%=world3"
      title: 'Scoreboard 3'
      lines:
      - 'You are in world world3'
    # none of the conditions above passed, display default scoreboard
    default:
      title: 'Default scoreboard'
      lines:
      - 'You are not in any of the worlds listed above'
```