# 共用玩家列表

## 关于

这个功能允许你在一个子服查看整个群组服所有的在线玩家而不是与你在同一个服务器的玩家。\
要启用这个功能，你需要将 TAB 安装到 BC 上。这个功能不支持 Bukkit，并且后续也不会增加。

## 启用

打开 **config.yml** 并且找到如下部分：

```
global-playerlist:
  enabled: false
  display-others-as-spectators: false
  display-vanished-players-as-spectators: true
  isolate-unlisted-servers: false
  spy-servers:
    - spyserver1
    - spyserver2
  server-groups:
    lobbies:
      - lobby1
      - lobby2
    group2:
      - server1
      - server2
```

要启用该功能，修改以下设置：

```
global-playerlist:
  enabled: true
```

## 配置

### 通过分组共享玩家列表

在一些情况下，你只想要部分服务器而不是所有服务器都显示共同的玩家列表。这个配置将会给你帮助。默认的示例：

```
global-playerlist:
  server-groups:
    lobbies:
      - lobby1
      - lobby2
    group2:
      - server1
      - server2
```

这包含 2 个组，每个组包括 2 个服务器。服务器组的名称可以设置成任意值。（例如 "lobby" 或者 "group2"）。在每个组的名称下面，列出该组下的服务器名称，服务器名称取决于 BC 的 config.yml 文件的配置。

在这个设置中， "lobby1" 和 "lobby2" 服务器将会共享玩家列表， "server1" 和 "server2" 也是同理。所有未列出的服务器将会自动被分配到一个隐藏的默认组中。这意味着除了上面 4 个服务器的子服再共用玩家列表。

要实现所有子服通用一个玩家列表，可以将此选项设置为：

```
  server-groups: {}
```

### 配置隔离服务器

如果你想要设置某个子服隔离（别的服的玩家看不到这个服的玩家列表，这个服的玩家也看不到别的服的玩家列表），只需创建一个单独的组，然后将隔离的服务器放置到这即可:

```
global-playerlist:
  server-groups:
    test1:
      - isolatedServer1
    test2:
      - isolatedServer2
```

### 额外设置

`display-others-as-spectators: false`\
如果启用，玩家在不同的服务器将会以旁观者模式玩家显示在 TAB 列表中。

`display-vanished-players-as-spectators: true`\
如果启用，拥有查看隐身玩家权限的玩家(tab.seevanished)将会发现隐身的玩家会以旁观者模式显示(其他玩家则无法看到)。隐身的玩家将不会看到它们被标记为旁观者模式，因为这会导致一些问题。

`isolate-unlisted-servers: false`\
如果启用，没有被分组的服务器将不会显示全体玩家列表(TAB)。

## 与其他隐身插件兼容

该功能替换了原本的 TAB 列表，它会导致一些与其他隐身插件的兼容问题。要使得这些隐身插件正常工作，你需要在 BC 上使用 PremiumVanish 或者在所有子服安装隐身插件和 [TAB-Bridge](https://www.mc-market.org/resources/21641/) 插件。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.superiormc.cn/tab-wiki/core-features/gong-yong-wan-jia-lie-biao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.