Team Management
Create, join, leave, and manage teams — the core of SimpleTeams.
Creating Teams
Players create named teams with /team create <name>. The creator automatically becomes the team Leader.
Team names are validated against configurable rules:
Min/max name length (default 3–24 characters), allowed character regex (default a-zA-Z0-9_-), and a blacklist of prohibited names.
There is a global team limit (default 100 teams). Once reached, no new teams can be created until existing ones are disbanded.
Joining Teams
There are two ways to join a team:
Public/Open Teams — Use /team join to see a list of open teams, then /team join <team> to join one. Tab completion only shows open teams.
Invite-only/Closed Teams — Requires an invitation from a Moderator or higher. See the Invites page for details.
Leaving Teams
Use /team leave to leave your current team.
If the team Leader leaves, the team is automatically disbanded. There is no confirmation prompt — be careful.
Team Info
Use /team info [team] to view detailed information about a team. This shows:
Team name, prefix, open/closed status, member count (current/max), creation date, and all members sorted by rank.
If no team name is provided, it shows info for your own team.
Team List & Top
/team list — Shows all teams on the server alphabetically, with the leader name and member count for each.
/team top — Shows the top N teams (configurable, default 10) ranked by member count.
Open & Close
Moderators and above can toggle their team's public status:
/team open — Makes the team publicly joinable. Any player can use /team join to see and join it.
/team close — Makes the team invite-only. Players must receive an invitation to join.
Configuration
| Option | Default | Description |
|---|---|---|
| limits.max-teams | 100 | Maximum number of teams on the server |
| limits.max-members-per-team | 20 | Maximum members per team |
| limits.max-name-length | 24 | Maximum team name length |
| limits.min-name-length | 3 | Minimum team name length |
| validation.allowed-name-chars | a-zA-Z0-9_- | Regex character class for allowed name characters |
| validation.blacklisted-names | [] | Case-insensitive list of prohibited team names |
Permissions
| Permission | Default | Description |
|---|---|---|
| simpleteams.player.create | Everyone | Create a new team |
| simpleteams.player.join | Everyone | Join an open team |
| simpleteams.player.leave | Everyone | Leave your team |
| simpleteams.player.info | Everyone | View team information |
| simpleteams.player.list | Everyone | List all teams |
| simpleteams.player.top | Everyone | Show top teams by member count |
| simpleteams.player.open | Everyone | Make team publicly joinable |
| simpleteams.player.close | Everyone | Make team invite-only |
| simpleteams.player.disband | Everyone | Disband your team |