Simply Teams

Simply Teams

一款服务端 Minecraft 模组，用扩展的队伍管理系统替换原版/team命令。

项目信息

• 作者：Yigit_Guven
• 许可证：MIT
• 运行环境：仅服务端（客户端无需安装此模组）

相关链接

• GitHub 仓库：https://github.com/yigit-guven/Simply-Teams
• 问题反馈：https://github.com/yigit-guven/Simply-Teams/issues
• 文档 Wiki：https://github.com/yigit-guven/Simply-Teams/wiki
• CurseForge：https://www.curseforge.com/minecraft/mc-mods/simply-teams/
• Modrinth：https://modrinth.com/mod/simply-teams/

简介

Simply Teams 会移除原版/team命令树，并用独立的队伍系统取而代之。此模组完全运行在服务端。连接到服务器的客户端（原版、安装了模组的客户端，或 Geyser 等代理连接）均无需安装此模组，即可加入服务器并使用所有功能。

主要功能

• 替换命令：彻底移除原版/team命令并替换为新命令。
• 根据情境提供命令建议：未加入队伍的玩家只会看到创建或加入队伍相关的命令；队伍成员则会看到管理命令。命令树会动态更新，无需重新连接。
• 支持带空格的显示名称：队伍名称可以包含空格。最大长度可配置（默认不限制）。
• 队伍 ID：内部队伍标识符与创建者的用户名相同。
• 邀请：可点击的交互式聊天邀请，并支持配置过期时间。
• 成员界面：使用原生的 54 格箱子界面（MenuType.GENERIC_9x6）展示成员的玩家头像、皮肤（在线及离线）、阶级格式和加入日期，并支持分页。界面槽位为只读，防止玩家移动物品。
• 玩家列表格式：在玩家列表中显示队伍前缀、玩家名称、队伍图标和队伍后缀。
• 队伍图标：将玩家主手持有的物品设为队伍图标。
• 阶级管理：可自定义阶级层级、优先级数值、颜色、粗体格式和细粒度权限。
• 队伍家园：可设置队伍基地并传送至此。
• 队伍聊天：专用的队伍聊天命令，以及可持续启用的队伍聊天模式。
• 队友伤害：可按队伍配置队友之间的伤害保护。
• 数据持久化：所有数据均以 NBT 格式保存至世界存档（TeamSavedData），服务器重启后仍会保留。
• 记分板集成：与原版记分板队伍同步，用于设置名称颜色和名牌可见性。

命令

未加入队伍的玩家

队伍成员

仅限队长使用的命令

阶级管理命令

管理员命令（OP 等级 2 及以上／控制台）

当配置中启用opsAreAdmins时可用（默认：true）。如果opsAreAdmins为false，则管理员会被严格视为普通玩家，无法使用这些命令。

权限参考

默认等级结构：

• leader：优先级 100，金色、粗体，拥有所有权限。无法降级或删除。
• officer：优先级 50，青色，拥有 INVITE、KICK、CHANGE_ICON、CHAT。
• member：优先级 10，灰色，拥有 CHAT。

服务器配置

配置文件位置：world/serverconfig/simply_teams-server.toml（或 config/simply_teams-server.toml）。

[teams]
  # Maximum character length for team display names. Use -1 for unlimited length.
  # Range: -1 ~ 256
  maxDisplayNameLength = -1

  # Whether teams are allowed to have custom colors.
  allowTeamColor = true

  # Whether teams are allowed to have custom prefixes.
  allowTeamPrefix = true

  # Whether teams are allowed to have custom suffixes.
  allowTeamSuffix = true

  # Maximum character length for team prefixes. Use -1 for unlimited.
  # Range: -1 ~ 64
  maxPrefixLength = 16

  # Maximum character length for team suffixes. Use -1 for unlimited.
  # Range: -1 ~ 64
  maxSuffixLength = 16

  # Duration in seconds before a team invitation expires.
  # Range: 5 ~ 600
  inviteTimeoutSeconds = 60

  # Whether teams can set and teleport to a shared team home base.
  allowTeamHome = true

[admin]
  # Whether server operators (OPs) have administrative privileges for Simply Teams.
  # When true (default), operators can manage or delete other teams (/team admin) and bypass team permissions.
  # When false, operators are treated strictly as regular players, allowing OPs to play normally without admin team powers.
  opsAreAdmins = true

[tab_list]
  # Whether to show the team icon in the server player list (TAB).
  showIcon = true

  # Whether to show the team prefix in the server player list (TAB).
  showPrefix = true

  # Whether to show the team suffix in the server player list (TAB).
  showSuffix = true

  # Format string for the team icon in the player list. %s represents the item name.
  iconFormat = "[%s]"