# TAB 列表名称样式

## 启用

要启用该功能，请在 **config.yml** 设置

```
tablist-name-formatting:
  enabled: true
```

将 `enabled` 设置为 `false` 将会禁用该功能。

## 配置

### 介绍

玩家在 **TAB** 显示名称由以下部分组成:\
`tabprefix` - 位于显示名称的前面，一般是玩家名称的前缀。\
`customtabname` - 显示名称的中间部分，它一般用于显示你在配置文件设置的自定义的名称。如果我们无法检查到 customtabname 的值，将会显示玩家的真实名称。\
`tabsuffix` -位于显示名称的后面，一般是玩家名称的后缀。

### 分组和玩家

玩家具体显示哪个 **TAB** 显示名称将可以由 **2** 种方式决定: 分组和单独给玩家本身。玩家可以是由他们的玩家名称或者 **UUID** 来定义，单独给玩家本身的值权重值比玩家所在的组设置的 **TAB** 显示名称高。\
**groups.yml**

```
admin:
  tabprefix: "&4&lAdmin &r"
```

你也可以通过指令来配置，以这个配置为例，则为 `/tab group admin tabprefix "&4&lAdmin &r"`。

**users.yml**

```
_NEZNAMY_:
  tabprefix: "&6&lTAB &r"

# 使用 UUID 单独给玩家
237d8b55-3f97-4749-aa60-e9fe97b45062:
  tabprefix: "&6&lTAB &r"
```

你也可以通过指令来配置，以这个配置为例，则为 `/tab player _NEZNAMY_ tabprefix "&4&lAdmin &r"` 或者 `/tab playeruuid _NEZNAMY_ tabprefix "&4&lAdmin &r"`。

你也可以通过 `_DEFAULT_` 来给没有任何分组，也没被单独给予 TAB 名称标签的玩家单独的标签。\
**groups.yml**

```
admin:
  tabprefix: "&4&lAdmin &r"
_DEFAULT_:
  tabprefix: "&7" # 在这个配置中，这代表除了 admin 分组外玩家全部给予这个 TAB 名称标签
```

### 分世界/分服务器

TAB 名称标签的值可以根据玩家所在的世界（或者 BC 所在的服务器）来分开。这里设置的值将比通用的 TAB 名称标签高。

示例:\
**groups.yml**

```
per-world:
  world1:
    _DEFAULT_:
      tabprefix: "&a" # 所有在 "world1" 世界的玩家将有这个 TAB 标签
per-server:
  server1:
    _DEFAULT_:
      tabprefix: "&a" # 所有在 "server1" 服务器的玩家将要这个 TAB 标签
```

多个世界或者服务器使用同一个配置，可以使用`;` 符号分开。\
如果多个服务器或者世界使用相同的开头，那么你可以用 `*` 符号代替不同时的位置。\
示例:

```
per-world:
  world1;world2:
    _DEFAULT_:
      tabsuffix: "world1 和 world2 通用的配置"
  lobby-*:
    _DEFAULT_:
      tabsuffix: "以 lobby- 开头的世界通用的配置"
```

### 权重值相同

整个权重值的列表如下:

1. 单独通过玩家名称给玩家的分世界/分服务器的 TAB 名称标签
2. 单独通过UUID给玩家的分世界/分服务器的 TAB 名称标签
3. 单独通过玩家名称给玩家的通用的 TAB 名称标签
4. 单独通过UUID给玩家的通用的 TAB 名称标签
5. 分组的分世界/分服务器 TAB 名称标签
6. 分组中 `_DEFAULT_` 的分世界/分服务器 TAB 名称标签
7. 分组的通用 TAB 名称标签
8. 分组中 `_DEFAULT_` 的通用 TAB 名称标签

一旦玩家拥有列表中最优先的一种 TAB 名称标签，那么玩家将会直接显示它。如果没有找到，将会返回空值（除了 `customtabname`，它将返回玩家的名称）。\
各个不同的值是互相独立的，这意味着您可以设置多个分世界/分服务器的 TAB 名称标签（因为您的服务器有多个世界、您的 BC 有多个服务器），但同种的通用的 TAB 名称标签只能有一个。

### Placeholder 支持

所有的 TAB 名称标签全部支持 [TAB 的内部变量符](/tab-wiki/functions/bian-liang-fu.md#nei-bu-bian-liang-fu) 和 [PlaceholderAPI ](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)变量符。变量符的数量不受限制，它们也可以和文本一起使用。

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

```
tablist-name-formatting:
  disable-in-worlds:
    - disabledworld
  disable-in-servers:
    - disabledserver
```

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

```
tablist-name-formatting:
  disable-in-worlds:
    - WHITELIST
    - enabledworld
```

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

## 提示

如果你想让 TAB 只显示权限组插件的权限组信息，删除 **groups.yml** 中的所有组并只保留如下内容:

```
_DEFAULT_:
  tabprefix: "%vault-prefix%"
  tabsuffix: "%vault-suffix%"
```

这代表着与 Vault 挂钩的权限组插件的前缀和后缀变量符。对于LuckPerms，你可以使用 `%luckperms-prefix%` 和 `%luckperms-suffix%` 替代。 

## 附加信息

如果你禁用了该功能，**TAB** 列表将会显示名称标签的前缀和后缀。这是 MC 原版的机制。如果你不想要在 **TAB** 列表显示前缀和后缀，请开启该功能，但保持前缀和后缀空白即可。关闭此功能只在你需要其他插件管理该功能时有用。


---

# 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/tab-lie-biao-ming-cheng-yang-shi.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.