BalancedTeam

---

A high-performance Clan/Team plugin for Anarchy and survival-competitive Minecraft servers (Minecraft 1.16+). Compatible with Bukkit / Spigot / Paper.

---

Features

• Team Management — Create, disband, invite, kick, promote, transfer leadership, apply to join
• Diplomacy — Ally / Unally, War / Peace with configurable caps to prevent server-wide coalitions
• Balance Mechanics — Friendly fire toggle (with cooldown), ally protection, leave cooldown against backstabs
• Team Chat — /tc channel with lock mode; OP spy mode to monitor all channels (can disable)
• Graphical GUI — Team menu, member management, server-wide list, confirmation dialogs
• Dual Storage — MySQL (production) / SQLite (zero-config), backed by HikariCP
• PlaceholderAPI Support — Full PlaceholderAPI integration with dozens of team and player placeholders
• Auto Multi-Language System — Auto-detects Minecraft client locale via Player.getLocale(), with smart fuzzy matching (e.g. zh_HK falls back to zh_CN/zh_TW), server fallbacks, and in-memory caching. Built-in zh_CN / zh_TW / en_US; players can override or reset via /teamlang; supports language codes or relative paths (e.g. lang/en_US.yml or en_US) in config.yml, which automatically adapts all server console output logs (startup banner, database, cache preloading, lifecycle, etc.) to the configured language
• Comprehensive Official Wiki — Complete GitHub Wiki Documentation covering installation, configuration, commands, GUI guide, and combat mechanics

---

Installation

1. Download the latest BalancedTeam-x.x.x.jar from Releases
2. Drop it into your server's plugins/ folder and restart
3. Edit plugins/BalancedTeam/config.yml (defaults to SQLite — no extra setup needed)
4. Restart or /reload confirm to apply

---

Commands

Click to expand / collapse Command List

/team (aliases: /t /clan /bt)

Command	Description	Permission / Role
/team (or /team menu)	Open interactive GUI dashboard	Everyone
/team create <name>	Create a new team	Everyone (No team)
/team disband	Disband your team (requires confirmation)	Leader
/team invite <player>	Invite a player to join	Leader / Officer
/team kick <player>	Kick a member from your team	Leader / Officer
/team leave	Leave current team (subject to cooldown)	Member / Officer
/team promote <player>	Promote a member to officer	Leader
/team demote <player>	Demote an officer to member	Leader
/team transfer <player>	Transfer team leadership	Leader
/team apply <team>	Apply to join a team	Everyone (No team)
/team accept <target>	Accept incoming member invite or alliance request	Leader / Officer
/team deny <target>	Reject incoming member invite or alliance request	Leader / Officer
/team ally <add|accept|remove> <team>	Send, accept, or break formal team alliance	Leader / Officer
/team enemy <add|remove> <team>	Declare hostility or remove enemy status	Leader / Officer
/team truce <team>	Send truce/peace request to an enemy team	Leader / Officer
/team truce accept <team>	Accept truce request & enter post-war protection	Leader / Officer
/team truce deny <team>	Reject incoming truce request	Leader / Officer
/team truce cancel <team>	Cancel outgoing truce request	Leader / Officer
/team truce list	View active incoming and outgoing truce requests	Leader / Officer
/team ff	Toggle friendly fire protection (subject to cooldown)	Leader / Officer
/team chat [message]	Send team chat message or toggle chat lock mode	Team Members
/team info [team]	View details of your team or another team	Everyone
/team members [page]	View member list and roles	Everyone
/team list [page]	Browse server team list GUI or chat	Everyone
/team lang [code|auto|list]	View or change personal client language preference	Everyone

/teamlang (aliases: /tlang /btlang /clanlang)

Command	Description	Permission
/teamlang	View current language code, detection mode, and help	balancedteam.use
/teamlang list	View all supported language packs loaded on server	balancedteam.use
/teamlang <code>	Manually switch to specific language (e.g. en_US, zh_CN)	balancedteam.use
/teamlang auto	Reset to automatic Minecraft client locale detection	balancedteam.use
/teamlang reload	Hot-reload all language configuration files	balancedteam.admin

/teamadmin (aliases: /ta /btadmin)

Command	Description	Permission
/teamadmin disband <team>	Force disband any team immediately	balancedteam.admin
/teamadmin kick <player>	Force remove a player from their team	balancedteam.admin
/teamadmin spy	Toggle admin spy mode to monitor all team chats	balancedteam.admin.spy
/teamadmin reload	Hot-reload config.yml and all language files	balancedteam.admin
/teamadmin help	Display administrator command help	balancedteam.admin

/teammsg (aliases: /tc /tm /teamchat)

Command	Description	Permission
/teammsg <message>	Send a quick message to your team channel	balancedteam.use
/teammsg	Toggle team chat lock mode (all chats route to team)	balancedteam.use

---

Permissions

Click to expand / collapse Permissions List

Permission	Default	Description
balancedteam.use	Everyone	Basic commands
balancedteam.admin	OP	Admin commands and language reload
balancedteam.admin.spy	OP	Monitor team chats

---

PlaceholderAPI Placeholders

Click to expand / collapse Placeholders & Configuration Examples

Native PlaceholderAPI expansion with %balancedteam_<placeholder>%:

Placeholder	Description
%balancedteam_in_team% / %balancedteam_has_team%	Whether player is in a team (true / false)
%balancedteam_name% / %balancedteam_team_name%	Player's team name
%balancedteam_id% / %balancedteam_team_id%	Player's team ID
%balancedteam_tag%	Formatted team tag (e.g. [TeamName])
%balancedteam_leader% / %balancedteam_leader_name%	Leader username
%balancedteam_leader_uuid%	Leader UUID
%balancedteam_is_leader%	Whether player is team leader (true / false)
%balancedteam_is_officer%	Whether player is officer or leader (true / false)
%balancedteam_role%	Role display name (e.g. Leader, Officer, Member)
%balancedteam_role_raw%	Role enum name (LEADER / OFFICER / MEMBER / NONE)
%balancedteam_role_level%	Role level number (3 / 2 / 1 / 0)
%balancedteam_description%	Team description
%balancedteam_friendly_fire% / %balancedteam_ff%	Friendly fire status (true / false)
%balancedteam_friendly_fire_formatted%	Formatted friendly fire status
%balancedteam_created_at%	Team creation time
%balancedteam_joined_at%	Player team join time
%balancedteam_members% / %balancedteam_member_count%	Current member count
%balancedteam_max_members%	Max allowed members
%balancedteam_online% / %balancedteam_online_count%	Online member count
%balancedteam_allies% / %balancedteam_ally_count%	Allied teams count
%balancedteam_max_allies%	Max allowed allies
%balancedteam_enemies% / %balancedteam_enemy_count%	Enemy teams count
%balancedteam_max_enemies%	Max allowed enemies
%balancedteam_allies_list%	List of ally team names
%balancedteam_enemies_list%	List of enemy team names
%balancedteam_total_teams%	Total teams on server
%balancedteam_total_members%	Total players in teams across server
%balancedteam_relation_<player>%	Relation with target player (SAME_TEAM / ALLY / ENEMY / NONE)
%balancedteam_relation_team_<teamName>%	Relation with target team (SAME_TEAM / ALLY / ENEMY / NONE)
%balancedteam_is_ally_<player>%	Whether target player is ally (true / false)
%balancedteam_is_enemy_<player>%	Whether target player is enemy (true / false)
%balancedteam_is_same_team_<player>%	Whether target player is teammate (true / false)
%balancedteam_team_leader_<teamName>%	Leader of specific team
%balancedteam_team_members_<teamName>%	Member count of specific team
%balancedteam_team_online_<teamName>%	Online member count of specific team
%balancedteam_team_desc_<teamName>%	Description of specific team
%balancedteam_team_created_<teamName>%	Creation time of specific team
%balancedteam_team_ff_<teamName>%	Friendly fire of specific team
%balancedteam_team_exists_<teamName>%	Whether specific team exists (true / false)

---

Support

If you find this project helpful, consider buying me a coffee!

---

License

MIT License