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. !(https://bstats.org/signatures/bukkit/SimpleTeams.svg) ## Features - **Full Team Management** -- Create, join, leave, and disband teams with customizable names and colored prefixes - **Rank System** -- Four-tier hierarchy: Member, Moderator, Co-Leader, and Leader with permission-based actions - **Invite System** -- Optional invite-only joining with configurable expiration times - **Team Chat** -- Private team chat channel toggleable per player with custom formatting - **Global Chat Integration** -- Optional team prefix injection into global chat messages - **Moderation Tools** -- Kick, ban, unban, promote, and demote team members with rank-aware restrictions - **Admin Override** -- Administrators can manage any team, transfer leadership, and bypass closed teams - **Persistent Storage** -- All team data saved to YAML with automatic loading and saving - **Update Notifications** -- 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 ` | `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 ` | `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: - **bStats** -- 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