Simply Teams

A server-sided Minecraft mod that replaces the vanilla /team command with an expanded team management system.

Project Information

• Author: Yigit_Guven
• License: MIT
• Environment: Server-side only (clients do not need the mod installed)

Links

• GitHub Repository: https://github.com/yigit-guven/Simply-Teams
• Issue Tracker: https://github.com/yigit-guven/Simply-Teams/issues
• Documentation 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/

Overview

Simply Teams unhooks the vanilla /team command tree and replaces it with an independent team system. The mod runs entirely on the server. Connecting clients (vanilla, modded, or proxy connections like Geyser) do not need to install the mod to join or use any features.

Key Capabilities

• Command replacement: The vanilla /team command is completely removed and replaced.
• Context-sensitive suggestions: Players without a team only see commands relevant to team creation or joining. Players in a team see operational commands. Command trees update dynamically without requiring reconnection.
• Spaced display names: Team names can contain spaces. Maximum length is configurable (default is unlimited).
• Leader ID: The internal team identifier matches the founder's username.
• Invitations: Interactive, clickable chat invitations with configurable expiration timeouts.
• Members UI: Uses the native 54-slot chest interface (MenuType.GENERIC_9x6) to show member player heads, skins (online and offline), rank formatting, join dates, and pagination. Slots are read-only to prevent item movement.
• Tab list formatting: Displays team prefix, player name, team icon, and team suffix in the player list.
• Team icon: Captures the item held in the player's main hand and sets it as the team icon.
• Rank management: Customizable rank hierarchy with priority numbers, colors, bold formatting, and granular permissions.
• Team home: Allows setting and teleporting to a team base.
• Team chat: Dedicated team chat command and a persistent team chat toggle mode.
• Friendly fire: Configurable per-team damage protection between teammates.
• Persistence: All data is saved to world storage (TeamSavedData) in NBT format and persists across server reboots.
• Scoreboard integration: Syncs with vanilla scoreboard teams for name colors and nametag visibility.

Commands

Players Without a Team

Team Members

Leader-Only Commands

Rank Management Commands

Administrator Commands (OP Level 2+ / Console)

Available when opsAreAdmins is enabled in configuration (true by default). When opsAreAdmins is false, operators are treated strictly as regular players and cannot access these commands.

Permissions Reference

Default rank structure:

• leader: Priority 100, Gold, Bold, contains all permissions. Cannot be demoted or deleted.
• officer: Priority 50, Aqua, contains INVITE, KICK, CHANGE_ICON, CHAT.
• member: Priority 10, Gray, contains CHAT.

Server Configuration

Configuration file location: world/serverconfig/simply_teams-server.toml (or 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]"