Description
Gallery
Changelog
Versions
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
All Versions
+ Add Version
[2.1.5] SimpleTeams 2.1.5
by _GodlyCow on Oct 15, 2026
Download
# Changelog
- [Update]** Updated FastStats from
0.22.0to0.30.0and migrated to the newBukkitContextAPI
- [Add]** Added FastStats Error Tracking with context-aware automatic error reporting
- [Remove]** Removed
bstats.enabledandfaststats.enabledconfig options (both are now always active)
[2.1.4] SimpleTeams 2.1.4
by _GodlyCow on Oct 15, 2026
Download
# Changelog
- [Add]** Added new placeholders:
- %simpleteams_kills% - your teams kills
- %simpleteams_deaths% - your teams deaths
- %simpleteams_kd% - your teams K/D (%simpleteams_kdr% alias)
- %simpleteams_kills_<team>%
- %simpleteams_deaths_<team>%
- %simpleteams_members_<team>% (size_ alias)
- %simpleteams_kd_<team>% (kdr_, kdratio_ aliases)
- %simpleteams_kills_top_<rank>% / %simpleteams_top_kills_<rank>%
- %simpleteams_deaths_top_<rank>% / %simpleteams_top_deaths_<rank>%
- %simpleteams_members_top_<rank>% / %simpleteams_top_members_<rank>%
- %simpleteams_kd_top_<rank>% / %simpleteams_top_kd_<rank>%
- %simpleteams_kills_rank_<team>%
- %simpleteams_deaths_rank_<team>%
- %simpleteams_members_rank_<team>%
- %simpleteams_kd_rank_<team>%
[2.1.3] SimpleTeams 2.1.3
by _GodlyCow on Oct 15, 2026
Download
# Changelog
- [Fix]** broken
/team closecommand
[2.1.2] SimpleTeams 2.1.2
by _GodlyCow on Oct 15, 2026
Download
- Removed** trailing space appended to team prefix on edit, which caused
%simpleteams_prefix%to render with an unwanted trailing space (e.g.[example ]instead of[example]).
[2.1.1] SimpleTeams 2.1.1
by _GodlyCow on Oct 15, 2026
Download
# Changelog
- [Fix]**
FastStatsManagerwas never initialized — wired up inonEnable()and exposed viagetFastStatsManager()
- [Fix]** Unused
kickerIdparameter removed fromTeamManager.kickMember()
- [Fix]**
%simpleteams_team_plain%placeholder was identical to%simpleteams_team%— now correctly strips MiniMessage tags from the prefix
- [Fix]**
EditCommandignored theallow-colored-prefixconfig option — colored prefixes are now properly gated
- [Fix]** Default team prefix was hardcoded in
Team.java— moved tolimits.default-prefix-formatinconfig.yml
- [Fix]**
/team banand/team unbanonly worked on online players — both now support offline players
- [Add]**
limits.default-prefix-formatkey inconfig.yml
- [Add]**
messages.ymlkeycoloredPrefixNotAllowed
- [Add]**
messages.ymlkeyplayerOfflineOrNotFound
[2.1.0] SimpleTeams 2.1.0
by _GodlyCow on Oct 15, 2026
Download
# Changelog
> **Note**: You need to have [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) installed to use placeholders.
- Fixed** the Modrinth update checker not working due to a malformed API URL.
- Added** full Folia support via a new internal scheduler that automatically detects and routes to the correct threading API.
- Added** a PlaceholderAPI expansion with 13 placeholders
%simpleteams_team%, %simpleteams_rank%, etc.).> **Note**: You need to have [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) installed to use placeholders.
- Added** team descriptions (
/team edit description <text>).
- Added** team color support (
/team edit color <minimessage>).
- Added** team MOTD support (
/team edit motd <text>), shown to members on login.
- Added**
description,color, andmotdtab completions to/team edit.
- Added**
softdependfor PlaceholderAPI toplugin.yml.
- Added**
max-description-lengthandmax-motd-lengthlimits toconfig.yml.
- Added**
motd.show-on-jointoggle toconfig.yml.
[2.0.0] SimpleTeams 2.0.0
by _GodlyCow on Oct 15, 2026
Download
Read description
[1.0.0] SimpleTeams 1.0.0
by _GodlyCow on Oct 15, 2026
Download
# SimpleTeams
A lightweight team management plugin for Spigot/Paper servers. Create organized teams with ranks, permissions, and customizable features.
## Features
## Player Commands
/team create <name> - Create a team
/team join <team> - Join an open team
/team leave - Leave your team
/team info [team] - View team info
/team list - List all teams
/team open - Open team to public
/team close - Close team
/team kick <player> - Kick a member
/team promote <player> - Promote member
/team demote <player> - Demote member
/team ban <player> - Ban player from team
/team unban <player> - Unban player
/team edit <prefix|name> - Edit team settings
/team help - Help menu
## Admin Commands
/team disband [team] - Disband any team
/team adminkick <player> - Kick from any team
## Permissions
simpleteams.player.* - All player commands (default: true)
simpleteams.admin.* - All admin commands (default: op)
simpleteams.admin.bypass - Bypass join restrictions
## Configuration
config.yml:
limits:
max-teams: 100
max-members-per-team: 20
chat-format:
enabled: true
format: "%prefix% %player%: %message%"
Messages are fully customizable in messages.yml
Placeholders: %team%, %player%, %rank%, %prefix%
## Quick Start
Players:
/team create MyTeam
/team open
/team promote Steve
Admins:
/team disband MyTeam
/team adminkick Player
Requires: Java 17+, Spigot/Paper 1.16+
License: MIT
A lightweight team management plugin for Spigot/Paper servers. Create organized teams with ranks, permissions, and customizable features.
## Features
- Customizable teams with prefixes
- 4 ranks: Leader, Co-Leader, Moderator, Member
- Open/closed team joining
- Persistent YAML storage
- Admin and player commands
- Team bans, promotions, demotions
- Chat prefix integration
- Configurable limits and messages
## Player Commands
/team create <name> - Create a team
/team join <team> - Join an open team
/team leave - Leave your team
/team info [team] - View team info
/team list - List all teams
/team open - Open team to public
/team close - Close team
/team kick <player> - Kick a member
/team promote <player> - Promote member
/team demote <player> - Demote member
/team ban <player> - Ban player from team
/team unban <player> - Unban player
/team edit <prefix|name> - Edit team settings
/team help - Help menu
## Admin Commands
/team disband [team] - Disband any team
/team adminkick <player> - Kick from any team
## Permissions
simpleteams.player.* - All player commands (default: true)
simpleteams.admin.* - All admin commands (default: op)
simpleteams.admin.bypass - Bypass join restrictions
## Configuration
config.yml:
limits:
max-teams: 100
max-members-per-team: 20
chat-format:
enabled: true
format: "%prefix% %player%: %message%"
Messages are fully customizable in messages.yml
Placeholders: %team%, %player%, %rank%, %prefix%
## Quick Start
Players:
/team create MyTeam
/team open
/team promote Steve
Admins:
/team disband MyTeam
/team adminkick Player
Requires: Java 17+, Spigot/Paper 1.16+
License: MIT
