About
SimpleTeams is a lightweight, fast, and feature-rich teams plugin for modern Minecraft servers. Create teams, invite friends, chat in team channels, track kills and deaths, and manage everything with a powerful command system - all with full Folia support.
Features
Click to expand full feature list
Team Management
- Create & Disband Teams - Set up your team in seconds
- Invite System - Send and accept time-limited invites
- Join & Leave - Easily join friends or go solo
- Kick & Ban - Remove unwanted members and ban players from your team
- Promote & Demote - Manage ranks within your team (Member - Officer - Leader)
- Set Leader - Transfer leadership to another member
Team Chat & Communication
- Team Chat - Dedicated team-only chat channel
- Custom Chat Format - MiniMessage-powered formatting with team prefix support
- Team MOTD - Show a custom message when members join
Team Identity
- Custom Prefixes - Colored team tags displayed in chat
- Team Descriptions - Describe your team's purpose
- Team Tag - Visible identifier for your team
Leaderboards & Stats
- Leaderboard - Top teams ranked by kills, deaths, or K/D ratio
- Kill & Death Tracking - Track team combat statistics automatically
- PlaceholderAPI Integration - Use team data in scoreboards, TAB, and other plugins
Administration
- Admin Commands - Server staff can manage any team (kick, disband, set leader)
- Permission System - Granular per-command permissions for players and admins
- Reload - Reload configuration and messages without restarting
- Update Checker - Notifies staff when a new version is available
Compatibility
- Folia Support - Full region-aware scheduling for Folia servers
- PlaceholderAPI - Extensive placeholder support for other plugins
- MiniMessage - Modern chat formatting with color gradients and formatting
...and more!
Compatibility
SimpleTeams is built for Bukkit-based servers and supports Minecraft 1.21+
Supported Software & System Requirements
Software Support
| Software | Status |
|---|---|
| Paper | Supported |
| Purpur | Supported |
| Folia | Supported |
| Other Forks | Supported* |
| Spigot | Not Supported |
| Bukkit | Not Supported |
*Forks that do not modify the core Bukkit API are supported.
Requirements
- Java Version: 21+
- Minecraft Version: 1.21+
- Server Platform: A supported server software listed above
Commands
Click to view all commands
| Command | Description | Permission |
|---|---|---|
/team create <name> | Create a new team | simpleteams.player.create |
/team join <name> | Join an open team | simpleteams.player.join |
/team leave | Leave your current team | simpleteams.player.leave |
/team disband | Disband your team (leader only) | simpleteams.player.disband |
/team info [name] | View team information | simpleteams.player.info |
/team list | List all teams | simpleteams.player.list |
/team top | View the team leaderboard | simpleteams.player.top |
/team open | Make your team joinable | simpleteams.player.open |
/team close | Make your team invite-only | simpleteams.player.close |
/team kick <player> | Kick a member from your team | simpleteams.player.kick |
/team promote <player> | Promote a team member | simpleteams.player.promote |
/team demote <player> | Demote a team member | simpleteams.player.demote |
/team invite <player> | Invite a player to your team | simpleteams.player.invite |
/team accept | Accept a pending invite | simpleteams.player.accept |
/team deny | Deny a pending invite | simpleteams.player.deny |
/team chat <message> | Send a message to team chat | simpleteams.player.chat |
/team ban <player> | Ban a player from your team | simpleteams.player.ban |
/team unban <player> | Unban a player from your team | simpleteams.player.unban |
/team edit <option> <value> | Edit team settings | simpleteams.player.edit |
/team setleader <player> | Transfer team leadership | simpleteams.player.setleader |
/team help | Show the help menu | simpleteams.player.help |
Placeholders
PlaceholderAPI Placeholders
Player Placeholders
| Placeholder | Description |
|---|---|
%simpleteams_has_team% | Whether the player has a team (true/false) |
%simpleteams_team% | Player's team name |
%simpleteams_team_plain% | Player's team name (no formatting) |
%simpleteams_team_formatted% | Player's team name (legacy formatted) |
%simpleteams_prefix% | Player's team prefix (legacy formatted) |
%simpleteams_prefix_plain% | Player's team prefix (no formatting) |
%simpleteams_prefix_formatted% | Player's team prefix (legacy formatted) |
%simpleteams_rank% | Player's rank display name in the team |
%simpleteams_rank_name% | Player's rank enum name (LEADER, OFFICER, MEMBER) |
%simpleteams_leader% | Team leader's name |
%simpleteams_size% | Number of members in the team |
%simpleteams_max_size% | Maximum allowed team size |
%simpleteams_description% | Team description |
%simpleteams_color% | Team color |
%simpleteams_status% | Team status (Open or Closed) |
%simpleteams_motd% | Team message of the day |
%simpleteams_created% | Team creation date (yyyy-MM-dd) |
Team Stats Placeholders
| Placeholder | Description |
|---|---|
%simpleteams_kills% | Team's total kills |
%simpleteams_deaths% | Team's total deaths |
%simpleteams_kd% | Team's K/D ratio |
%simpleteams_kdr% | Team's K/D ratio (alias) |
Leaderboard Placeholders
| Placeholder | Description |
|---|---|
%simpleteams_kills_top_% | Team name at the given rank on the kills leaderboard |
%simpleteams_deaths_top_% | Team name at the given rank on the deaths leaderboard |
%simpleteams_members_top_% | Team name at the given rank on the members leaderboard |
%simpleteams_kd_top_% | Team name at the given rank on the K/D leaderboard |
%simpleteams_top_kills_% | Team name at the given rank on the kills leaderboard |
%simpleteams_top_deaths_% | Team name at the given rank on the deaths leaderboard |
%simpleteams_top_members_% | Team name at the given rank on the members leaderboard |
%simpleteams_top_kd_% | Team name at the given rank on the K/D leaderboard |
Per-Team Stat Placeholders
| Placeholder | Description |
|---|---|
%simpleteams_kills_<team>% | Kills for a specific team |
%simpleteams_deaths_<team>% | Deaths for a specific team |
%simpleteams_members_<team>% | Member count for a specific team |
%simpleteams_kd_<team>% | K/D ratio for a specific team |
%simpleteams_kills_rank_<team>% | Kills leaderboard rank for a specific team |
%simpleteams_deaths_rank_<team>% | Deaths leaderboard rank for a specific team |
%simpleteams_members_rank_<team>% | Members leaderboard rank for a specific team |
%simpleteams_kd_rank_<team>% | K/D leaderboard rank for a specific team |
Project Information
Contributing
Contributions are always welcome! If you have an idea, find a bug, or want to improve something, feel free to open an issue or submit a pull request on GitHub.
Before contributing, please make sure your changes fit the project and are properly tested.
Metrics & Error Tracking
SimpleTeams uses bStats and FastStats for anonymous usage statistics and error tracking.
- bStats collects anonymous server data (server version, player count, plugin version)
- FastStats provides error tracking and advanced metrics to help identify and fix issues faster
SimpleTeams is developed by me in my free time
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.3MSueta
Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
Chunky
Pre-generates chunks, quickly and efficiently
20.8MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta