一个 玩家集合 是一个你全部玩家的子集，每个玩家集合都有其名字。玩家集合在插件显示玩家与玩家数量时会用到。

玩家集合在Tab列表配置文件中定义。一个简单的包含所有玩家的 玩家集合 可以像这样创建：

playerSets:
  all_players: # 玩家集合的名字
    filter: all # 包含所有玩家


现在你可以使用这个 玩家集合 在你服务器的页眉与页脚中显示玩家数量了：

footer:
- '&7Total players:&f ${playerset:all_players size}'


就如你从上面的例子中看到的那样。 ${playerset:all_players size} 占位符可以显示 玩家集合 中玩家的数量。所有的 玩家集合 都可以这样使用：使用 ${playerset:<name> size} 显示特定 玩家集合 中玩家的数量。

我们来创建一个 玩家集合 只包含特定服务器上的玩家。在这个例子中，假装这里有一个叫做 lobby 的服务器。

playerSets:
  all_players:
    filter: all
  lobby:
    filter: ${player server} == "lobby"


现在还不是很难。让我们再创建一个服务器 survival 的 玩家集合 。

playerSets:
  all_players:
    filter: all
  lobby:
    filter: ${player server} == "lobby"
  survival:
    filter: ${player server} == "survival"


使用这些在页脚显示服务器玩家数量：

footer:
- |-
  &7Total players:&f ${playerset:all_players size}
  Lobby: ${playerset:lobby size} | Survival: ${playerset:survival size}


现在来说一下，在 玩家集合 的 filter (过滤器)中使用占位符。当添加玩家到集合中时，通常你会需要使用占位符的 player 变种。

最后但也同样重要的，我们来创建一个包含所有管理员的 玩家集合。这个例子中认为拥有 admin 或者 owner 权限组的玩家是管理员：

playerSets:
  all_players:
    filter: all
  lobby:
    filter: ${player server} == "lobby"
  survival:
    filter: ${player server} == "survival"
  admins:
    filter: ${player vault_primary_group} == "admin" or ${player vault_primary_group} == "owner"


为了增加可读性，复杂的 filter (过滤器)可以被分成多行：

playerSets:
  all_players:
    filter: all
  lobby:
    filter: ${player server} == "lobby"
  survival:
    filter: ${player server} == "survival"
  admins:
    filter: |-
      ${player vault_primary_group} == "admin"
      or ${player vault_primary_group} == "owner"