BalancedTeam
一款面向 Anarchy(无政府)和 生存竞技 Minecraft 服务器(Minecraft 1.16+)的高性能公会/战队插件。兼容 Bukkit / Spigot / Paper。
功能特性
- 队伍管理 — 创建、解散、邀请、踢出、晋升、转让领导权、申请加入
- 外交系统 — 结盟 / 解除结盟,宣战 / 和平;可配置上限以防止全服范围的联盟
- 平衡机制 — 友伤开关(含冷却时间)、盟友保护、针对背叛行为的退出冷却
- 队伍聊天 —
/tc频道及锁定模式;OP 间谍模式可监控所有频道(可禁用) - 图形化 GUI — 队伍菜单、成员管理、全服列表、确认对话框
- 双存储支持 — MySQL(生产环境)/ SQLite(零配置),由 HikariCP 提供支持
- PlaceholderAPI 支持 — 完整的 PlaceholderAPI 集成,提供数十种队伍与玩家占位符
- 自动多语言系统 — 通过
Player.getLocale()自动检测 Minecraft 客户端区域设置,具备智能模糊匹配(例如zh_HK回退至zh_CN/zh_TW)、服务器默认回退以及内存缓存。内置zh_CN/zh_TW/en_US;玩家可通过/teamlang覆盖或重置偏好;支持在config.yml中使用语言代码或相对路径(如lang/en_US.yml或en_US),并自动将所有服务器控制台输出日志(启动横幅、数据库、缓存预加载、生命周期等)适配为配置的语言 - 全面的官方 Wiki — 完整的 GitHub Wiki 文档,涵盖安装、配置、命令、GUI 指南和战斗机制
安装
- 从 Releases 下载最新的
BalancedTeam-x.x.x.jar - 将其放入服务器的
plugins/文件夹并重启 - 编辑
plugins/BalancedTeam/config.yml(默认为 SQLite — 无需额外设置) - 重启或执行
/reload confirm以应用更改
命令
点击展开 / 折叠命令列表
/team (别名: /t /clan /bt)
| 命令 | 描述 | 权限 / 角色 |
|---|---|---|
/team (或 /team menu) |
打开交互式 GUI 仪表盘 | 所有人 |
/team create <name> |
创建新队伍 | 所有人(无队伍时) |
/team disband |
解散你的队伍(需确认) | 队长 |
/team invite <player> |
邀请玩家加入 | 队长 / 官员 |
/team kick <player> |
将成员踢出队伍 | 队长 / 官员 |
/team leave |
离开当前队伍(受冷却限制) | 成员 / 官员 |
/team promote <player> |
晋升成员为官员 | 队长 |
/team demote <player> |
降级官员为成员 | 队长 |
/team transfer <player> |
转让队伍领导权 | 队长 |
/team apply <team> |
申请加入某支队伍 | 所有人(无队伍时) |
/team accept <target> |
接受入队邀请或结盟请求 | 队长 / 官员 |
/team deny <target> |
拒绝入队邀请或结盟请求 | 队长 / 官员 |
/team ally <add|accept|remove> <team> |
发送、接受或解除正式的队伍结盟 | 队长 / 官员 |
/team enemy <add|remove> <team> |
宣战或移除敌对状态 | 队长 / 官员 |
/team truce <team> |
向敌对队伍发送停战/和平请求 | 队长 / 官员 |
/team truce accept <team> |
接受停战请求并进入战后保护期 | 队长 / 官员 |
/team truce deny <team> |
拒绝收到的停战请求 | 队长 / 官员 |
/team truce cancel <team> |
取消发出的停战请求 | 队长 / 官员 |
/team truce list |
查看活动的待处理及已发出的停战请求 | 队长 / 官员 |
/team ff |
切换友伤保护(受冷却限制) | 队长 / 官员 |
/team chat [message] |
发送队伍聊天消息或切换聊天锁定模式 | 队伍成员 |
/team info [team] |
查看你所在队伍或其他队伍的详细信息 | 所有人 |
/team members [page] |
查看成员列表及角色 | 所有人 |
/team list [page] |
浏览全服队伍列表 GUI 或聊天 | 所有人 |
/team lang [code|auto|list] |
查看或更改个人客户端语言偏好 | 所有人 |
/teamlang (别名: /tlang /btlang /clanlang)
| 命令 | 描述 | 权限 |
|---|---|---|
/teamlang |
查看当前语言代码、检测模式及帮助信息 | balancedteam.use |
/teamlang list |
查看服务器上加载的所有支持的语言包 | balancedteam.use |
/teamlang <code> |
手动切换到特定语言(例如 en_US, zh_CN) |
balancedteam.use |
/teamlang auto |
重置为自动检测 Minecraft 客户端区域设置 | balancedteam.use |
/teamlang reload |
热重载所有语言配置文件 | balancedteam.admin |
/teamadmin (别名: /ta /btadmin)
| 指令 | 描述 | 权限 |
|---|---|---|
/teamadmin disband <team> |
立即强制解散任意队伍 | balancedteam.admin |
/teamadmin kick <player> |
强制将玩家从其队伍中移除 | balancedteam.admin |
/teamadmin spy |
切换管理员间谍模式以监控所有队伍聊天 | balancedteam.admin.spy |
/teamadmin reload |
热重载 config.yml 及所有语言文件 |
balancedteam.admin |
/teamadmin help |
显示管理员指令帮助信息 | balancedteam.admin |
/teammsg (别名: /tc /tm /teamchat)
| 指令 | 描述 | 权限 |
|---|---|---|
/teammsg <message> |
向你的队伍频道发送快速消息 | balancedteam.use |
/teammsg |
切换队伍聊天锁定模式(所有聊天均路由至队伍) | balancedteam.use |
权限
点击展开 / 收起权限列表
| 权限 | 默认值 | 描述 |
|---|---|---|
balancedteam.use |
所有人 | 基础指令 |
balancedteam.admin |
OP | 管理指令及语言重载 |
balancedteam.admin.spy |
OP | 监控队伍聊天 |
PlaceholderAPI 占位符
点击展开 / 收起占位符 & 配置示例
原生 PlaceholderAPI 扩展,使用 %balancedteam_<placeholder>%:
| 占位符 | 描述 |
|---|---|
%balancedteam_in_team% / %balancedteam_has_team% |
玩家是否在队伍中 (true / false) |
%balancedteam_name% / %balancedteam_team_name% |
玩家的队伍名称 |
%balancedteam_id% / %balancedteam_team_id% |
玩家的队伍 ID |
%balancedteam_tag% |
格式化后的队伍标签(例如 [TeamName]) |
%balancedteam_leader% / %balancedteam_leader_name% |
队长用户名 |
%balancedteam_leader_uuid% |
队长 UUID |
%balancedteam_is_leader% |
玩家是否为队伍队长 (true / false) |
%balancedteam_is_officer% |
玩家是否为官员或队长 (true / false) |
%balancedteam_role% |
角色显示名称(例如 Leader, Officer, Member) |
%balancedteam_role_raw% |
角色枚举名称 (LEADER / OFFICER / MEMBER / NONE) |
%balancedteam_role_level% |
角色等级数字 (3 / 2 / 1 / 0) |
%balancedteam_description% |
队伍描述 |
%balancedteam_friendly_fire% / %balancedteam_ff% |
友军伤害状态 (true / false) |
%balancedteam_friendly_fire_formatted% |
格式化后的友军伤害状态 |
%balancedteam_created_at% |
队伍创建时间 |
%balancedteam_joined_at% |
玩家加入队伍的时间 |
%balancedteam_members% / %balancedteam_member_count% |
当前成员数量 |
%balancedteam_max_members% |
允许的最大成员数 |
%balancedteam_online% / %balancedteam_online_count% |
在线成员数量 |
%balancedteam_allies% / %balancedteam_ally_count% |
盟友队伍数量 |
%balancedteam_max_allies% |
允许的最大盟友数 |
%balancedteam_enemies% / %balancedteam_enemy_count% |
敌对队伍数量 |
%balancedteam_max_enemies% |
允许的最大敌人数量 |
%balancedteam_allies_list% |
盟友队伍名称列表 |
%balancedteam_enemies_list% |
敌对队伍名称列表 |
%balancedteam_total_teams% |
服务器上队伍总数 |
%balancedteam_total_members% |
服务器上所有队伍中的玩家总数 |
%balancedteam_relation_<player>% |
与目标玩家的关系 (SAME_TEAM / ALLY / ENEMY / NONE) |
%balancedteam_relation_team_<teamName>% |
与目标队伍的关系 (SAME_TEAM / ALLY / ENEMY / NONE) |
%balancedteam_is_ally_<player>% |
目标玩家是否为盟友 (true / false) |
%balancedteam_is_enemy_<player>% |
目标玩家是否为敌人 (true / false) |
%balancedteam_is_same_team_<player>% |
目标玩家是否为队友 (true / false) |
%balancedteam_team_leader_<teamName>% |
特定队伍的队长 |
%balancedteam_team_members_<teamName>% |
特定队伍的成员数量 |
%balancedteam_team_online_<teamName>% |
特定队伍的在线成员数量 |
%balancedteam_team_desc_<teamName>% |
特定队伍的描述 |
%balancedteam_team_created_<teamName>% |
特定队伍的创建时间 |
%balancedteam_team_ff_<teamName>% |
特定队伍的友军伤害设置 |
%balancedteam_team_exists_<teamName>% |
特定队伍是否存在 (true / false) |
支持
如果你发现这个项目对你有帮助,请考虑给我买杯咖啡!
许可证
MIT License
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 —
/tcchannel 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_HKfalls back tozh_CN/zh_TW), server fallbacks, and in-memory caching. Built-inzh_CN/zh_TW/en_US; players can override or reset via/teamlang; supports language codes or relative paths (e.g.lang/en_US.ymloren_US) inconfig.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
- Download the latest
BalancedTeam-x.x.x.jarfrom Releases - Drop it into your server's
plugins/folder and restart - Edit
plugins/BalancedTeam/config.yml(defaults to SQLite — no extra setup needed) - Restart or
/reload confirmto 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
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BalancedTeam
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.2.5] - 2026-10-24
新增
- 控制台直接切换语言:
- 重构了
TeamLangCommand的执行流程,以消除在服务器控制台中运行/teamlang <code|auto>或/teamlang set <code|auto>时的player_only(仅限玩家)限制。 - 控制台命令执行会直接热切换服务器环境语言(
ServerLanguageManager),并将更新后的代码自动持久化到config.yml中的server_messages_language中,从而使所有控制台日志(PluginLogger)和控制台命令消息立即转换为目标语言,并在服务器重启后保持有效。 - 通过
/teamlang auto添加了控制台自动检测支持,检测主机 JVM 和操作系统区域设置(Locale.getDefault())并匹配最佳的可用服务器语言。 - 为控制台发送者升级了
/teamlang状态显示,包含主机环境区域信息,并统一了/teamlang list和 Tab 补全功能,以聚合内置的 7 种服务器语言(zh_CN,zh_TW,en_US,ja_JP,ru_RU,de_DE,es_ES)以及外部自定义语言包。
- 重构了
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧