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
No gallery available for this project.