SimpleTeams

SimpleTeams

A lightweight, modern teams plugin for Paper and Spigot Minecraft servers. Built with Adventure/MiniMessage for rich text formatting and designed for performance with clean, maintainable code.

Features

- Analytics Ready -- Create, join, leave, and disband teams with customizable names and colored prefixes - Analytics Ready -- Four-tier hierarchy: Member, Moderator, Co-Leader, and Leader with permission-based actions - Analytics Ready -- Optional invite-only joining with configurable expiration times - Analytics Ready -- Private team chat channel toggleable per player with custom formatting - Analytics Ready -- Optional team prefix injection into global chat messages - Analytics Ready -- Kick, ban, unban, promote, and demote team members with rank-aware restrictions - Analytics Ready -- Administrators can manage any team, transfer leadership, and bypass closed teams - Analytics Ready -- All team data saved to YAML with automatic loading and saving - Analytics Ready -- Built-in Modrinth version checker with in-game admin alerts - Analytics Ready -- Supports both bStats and FastStats for server-wide metrics collection

Commands

| Command | Permission | Description | |---------|-----------|-------------| | `/team create <name>` | `simpleteams.player.create` | Create a new team | | `/team join <team>` | `simpleteams.player.join` | Join an open team | | `/team leave` | `simpleteams.player.leave` | Leave your current team | | `/team info [team]` | `simpleteams.player.info` | View team information | | `/team list` | `simpleteams.player.list` | List all teams | | `/team top` | `simpleteams.player.top` | Top teams by member count | | `/team open` | `simpleteams.player.open` | Open team to public joining | | `/team close` | `simpleteams.player.close` | Close team from public joining | | `/team kick <player>` | `simpleteams.player.kick` | Kick a member from your team | | `/team promote <player>` | `simpleteams.player.promote` | Promote a team member | | `/team demote <player>` | `simpleteams.player.demote` | Demote a team member | | `/team disband [team]` | `simpleteams.player.disband` | Disband your team | | `/team ban <player>` | `simpleteams.player.ban` | Ban a player from your team | | `/team unban <player>` | `simpleteams.player.unban` | Unban a player from your team | | `/team edit <prefix|name> <value>` | `simpleteams.player.edit` | Edit team prefix or name | | `/team invite <player>` | `simpleteams.player.invite` | Invite a player to your team | | `/team accept` | `simpleteams.player.accept` | Accept a pending team invite | | `/team deny` | `simpleteams.player.deny` | Deny a pending team invite | | `/team chat` | `simpleteams.player.chat` | Toggle team-only chat mode | | `/team adminkick <player>` | `simpleteams.admin.kick` | Admin: kick from any team | | `/team setleader <team> <player>` | `simpleteams.admin.setleader` | Admin: transfer leadership | | `/team reload` | `simpleteams.admin.reload` | Reload config and messages | | `/team help` | `simpleteams.player.help` | Show command help |

Permissions

- `simpleteams.player.*` -- Grants all player commands (default: true) - `simpleteams.admin.*` -- Grants all admin commands (default: op) - `simpleteams.admin.bypass` -- Bypass closed team restrictions when joining

Configuration

All settings are managed through `config.yml`:

- Team limits (max teams, members per team, name length) - Name validation (allowed characters, blacklisted names) - Chat formatting (global and team chat formats) - Invite system (enable/disable, expiry time) - Update checker and bStats toggles

Messages are fully customizable in `messages.yml` using MiniMessage format.

Requirements

- Java 21 or higher - Paper 1.13+ or Spigot 1.13+

Metrics

This plugin collects anonymous usage statistics through: - FastStats -- Plugin usage trends and feature adoption - FastStats -- Performance and engagement analytics

Both can be disabled in the configuration.

Support

For bug reports, feature requests, or contributions, join my discord or GitHub repository.

https://bstats.org/signatures/bukkit/SimpleTeams.svg