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.

!Sum Text

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 [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:

• 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