/team

原文：Commands/team；源修订：3789537。

控制队伍。本命令为 Java 版独有，所需权限等级为 2。

语法

team list [<team>]
team add <team> [<displayName>]
team remove <team>
team empty <team>
team join <team> [<members>]
team leave <members>
team modify <team> <option> <value>

list：列出所有队伍及其显示名称、成员实体数量；可指定 team 仅列出某队伍。
add：创建指定名称和可选显示名称的队伍。省略 displayName 时，显示名称与 team 相同。
remove：删除指定队伍。
empty：从指定队伍中移除全部成员。
join：将指定实体加入指定队伍。省略实体时，让命令执行者加入。
leave：让指定实体离开各自的队伍。
modify：修改指定队伍的选项。

参数

team（list、remove、empty、join、modify 模式，team 类型）：已有队伍名称。
team（add 模式，string 类型）：新队伍名称，须为不含空格的单词字符串。
displayName（component）：队伍的显示名称，须为有效的文本组件。
members（score_holder）：加入或离开队伍的实体。可为玩家名称、UUID、目标选择器、虚构记分持有者名称，或表示全部记分持有者的 *；可选择多个对象。
option：要修改的具体选项，必须为下表之一。
value：该选项的新值，有效值见下文。

选项	作用
`displayName`	设置队伍显示名称
`color`	决定队伍及玩家在聊天、头顶名称、Tab 玩家列表和记分板侧栏中的颜色；也改变发光效果产生的实体轮廓颜色
`friendlyFire`	是否允许同队玩家互相造成伤害；仍可互相施加状态效果，不影响部分非玩家队伍成员；游戏规则 `pvp` 为 `false` 时，此选项无效
`seeFriendlyInvisibles`	决定同队隐身玩家对队友是半透明可见还是完全不可见
`nametagVisibility`	决定哪些人能看到头顶名称
`deathMessageVisibility`	控制玩家死亡消息的可见性
`collisionRule`	控制队伍实体与其他实体的碰撞方式
`prefix`	修改显示在玩家名称前的前缀
`suffix`	修改显示在玩家名称后的后缀

各选项的有效值

displayName：有效文本组件，指定显示名称。

color：team_color 类型，可以为 black、dark_blue、dark_green、dark_aqua、dark_red、dark_purple、gold、gray、dark_gray、blue、green、aqua、red、light_purple、yellow、white，也可为字面量 reset。默认为 reset，表示采用默认颜色和格式。

friendlyFire：布尔值 allowed。true（默认）允许同队玩家互相造成伤害；false 禁止。

seeFriendlyInvisibles：布尔值 allowed。true（默认）使同队隐身玩家以半透明形式可见；false 使其不可见。

`nametagVisibility` 值	效果
`never`	所有玩家均看不到其头顶名称
`hideForOtherTeams`	只有同队玩家能看到其头顶名称
`hideForOwnTeam`	同队玩家看不到其头顶名称
`always`（默认）	所有玩家均能看到其头顶名称

`deathMessageVisibility` 值	效果
`never`	向所有玩家隐藏死亡消息
`hideForOtherTeams`	向非同队玩家隐藏死亡消息
`hideForOwnTeam`	向同队玩家隐藏死亡消息
`always`（默认）	所有玩家均可见死亡消息

`collisionRule` 值	效果
`always`（默认）	正常碰撞
`never`	任何实体均不能推动该队伍实体
`pushOtherTeams`	该队伍实体只能被同队其他实体推动，与字面意义相反，见参考资料
`pushOwnTeam`	该队伍实体不能被同队其他实体推动，与字面意义相反，见参考资料

prefix：有效文本组件，指定显示前缀。suffix：有效文本组件，指定显示后缀。

结果

命令不完整或任一参数指定不正确时无法解析。下列情形失败，其他情况成功：

list <team>、remove、empty、join 或 modify：指定队伍不存在。
add：同名队伍已经存在。
empty：队伍已经为空。
join：命令执行者不是实体，却未指定 members；或成员目标无法解析为一个或多个实体。
leave：成员目标无法解析为一个或多个实体。
修改 displayName、color、friendlyFire、seeFriendlyInvisibles、nametagVisibility、deathMessageVisibility、collisionRule 时，指定值与当前值相同。

输出

失败时成功次数、成功值、结果值均为 0。成功时成功次数和成功值均为 1，结果值如下（保留源修订正文表格定义）：

命令	结果值
`team list`	现有队伍数量
`team list <team>`	指定队伍成员数量
`team add`、`team remove`	执行后现有队伍数量
`team empty`	执行前指定队伍成员数量
`team join`，未显式指定成员	1
`team join`，指定成员	指定实体数量
`team leave`	指定实体数量
修改显示名称、颜色、友军伤害、隐身可见性、名称可见性、死亡消息可见性或碰撞规则	0
修改 `prefix` 或 `suffix`	1

另见

/scoreboard：管理记分项、玩家和记分板显示。
/tag：为玩家添加指定字符串标签。

参考资料

MC-87984：队伍碰撞规则名称与实际行为相反。

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。