# 各世界玩家列表

## 关于

要使用此功能，你需要安装 **TAB** 到 Bukkit服务器。该功能无法在 **BC** 上使用。

## 启用

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

```
per-world-playerlist:
  enabled: false
  allow-bypass-permission: false
  ignore-effect-in-worlds:
    - ignoredworld
    - build
  shared-playerlist-world-groups:
    lobby:
      - lobby1
      - lobby2
    minigames:
      - paintball
      - bedwars
```

要启用该功能，设置：

```
per-world-playerlist:
  enabled: true
```

## 配置

### 按分组显示多世界的玩家

如果您想要多个世界共用一个玩家列表，在开启该功能后并设置组。示例：

```
per-world-playerlist:
  shared-playerlist-world-groups:
    lobby:
      - lobby1
      - lobby2
    minigames:
      - paintball
      - bedwars
```

包含 2 个组，每个组包含 2 个世界。世界组的名称可以是任何字符。世界组的下面列出该组包含的真实世界名称。

在这个示例中，"lobby1" 和 "lobby2" 将共用一个玩家列表， "paintball" 和 "bedwars" 也是这样。其他的所有世界将会再共用一个玩家列表。只创建 1 个组而该组又只有 1 个世界是没用的。

### 指定世界的玩家仍被全服玩家看到

如果尽管启用了此功能，但您希望玩家看到服务器上来自特定世界的每个人，您可以在以下位置列出这些世界：

```
per-world-playerlist:
  ignore-effect-in-worlds:
    - ignoredworld
    - build
```

现在，在 "ignoredworld" 和 "build" 世界的玩家会正常被所有玩家看到。

### 高级设置

`allow-bypass-permission: false`\
如果启用，拥有 `tab.bypass` 权限的玩家会正常看到所有玩家而不是一个世界的玩家。


---

# 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/ge-shi-jie-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.