SimpleTeams

# 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 ` | Create a new team | `simpleteams.player.create` | | `/team join ` | 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 ` | Kick a member from your team | `simpleteams.player.kick` | | `/team promote ` | Promote a team member | `simpleteams.player.promote` | | `/team demote ` | Demote a team member | `simpleteams.player.demote` | | `/team invite ` | 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 ` | Send a message to team chat | `simpleteams.player.chat` | | `/team ban ` | Ban a player from your team | `simpleteams.player.ban` | | `/team unban ` | Unban a player from your team | `simpleteams.player.unban` | | `/team edit ` | Edit team settings | `simpleteams.player.edit` | | `/team setleader ` | 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_%` | Kills for a specific team | | `%simpleteams_deaths_%` | Deaths for a specific team | | `%simpleteams_members_%` | Member count for a specific team | | `%simpleteams_kd_%` | K/D ratio for a specific team | | `%simpleteams_kills_rank_%` | Kills leaderboard rank for a specific team | | `%simpleteams_deaths_rank_%` | Deaths leaderboard rank for a specific team | | `%simpleteams_members_rank_%` | Members leaderboard rank for a specific team | | `%simpleteams_kd_rank_%` | 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](https://bstats.org/) and [FastStats](https://faststats.dev/) 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 --- [](https://modrinth.com/plugin/simpleteams) [](https://jitpack.io/#GodlyCow203/SimpleTeams/)  [](https://discord.gg/...)      ---