Mineforgian
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
- 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.
Ченджлог
2.1.1Релиз26.1, 26.1.1, 26.1.2 · 31 мая 2026 г.
Changelog
[Fix] FastStatsManager was never initialized — wired up in onEnable() and exposed via getFastStatsManager()
[Fix] Unused kickerId parameter removed from TeamManager.kickMember()
[Fix] %simpleteams_team_plain% placeholder was identical to %simpleteams_team% — now correctly strips MiniMessage tags from the prefix
[Fix] EditCommand ignored the allow-colored-prefix config option — colored prefixes are now properly gated
[Fix] Default team prefix was hardcoded in Team.java — moved to limits.default-prefix-format in config.yml
[Fix] /team ban and /team unban only worked on online players — both now support offline players
[Add] limits.default-prefix-format key in config.yml
[Add] messages.yml key coloredPrefixNotAllowed
[Add] messages.yml key playerOfflineOrNotFound
2.1.0Релиз26.1, 26.1.1, 26.1.2 · 10 мая 2026 г.
Changelog
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 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, and motd tab completions to /team edit.
Added softdepend for PlaceholderAPI to plugin.yml.
Added max-description-length and max-motd-length limits to config.yml.
Added motd.show-on-join toggle to config.yml.
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 22 апреля 2026 г.
Read description
1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 18 ноября 2025 г.
SimpleTeams
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 - Create a team /team join - 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 - Kick a member /team promote - Promote member /team demote - Demote member /team ban - Ban player from team /team unban - Unban player /team edit <prefix|name> - Edit team settings /team help - Help menu
Admin Commands
/team disband [team] - Disband any team /team adminkick - 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
Комментарии
Загружаем…