PlayerBalancer (Archived) - PlayerBalancer - 玩家负载均衡器

PlayerBalancer 是一款 BungeeCord 插件，用于搭建一个拥有多种类型大厅的网络。该插件高度可定制，提供了负载均衡、踢出处理、服务器检查、分区管理、权限路由等丰富功能，并支持 RedisBungee 和多种第三方插件。

💡主要特性

负载均衡

• 自动将玩家分配到指定分区内的服务器，实现负载均衡。
• 当玩家连接到一个分区的服务器时，插件可能会将其移动到该分区内的另一台服务器。

踢出处理器

• 玩家从服务器被踢出时，可自动转移到其他服务器。
• 可配置为仅在玩家因特定踢出消息被踢出时才生效。

服务器检查器

• 确保玩家即将连接的服务器在线且可访问。
• 可根据服务器 MOTD 标记服务器为不可访问状态。

分区服务器

• 在 BungeeCord 上创建一个虚拟服务器，用于代表整个分区。
• 玩家连接此虚拟服务器即可进入该分区，并显示分区内所有服务器的玩家总数。

权限路由器

• 当拥有特定权限的玩家尝试连接某个分区时，可将其重定向到另一个分区。
• 适用于为特殊权限玩家创建专属大厅分区。

Spigot 附加组件

• 允许 Spigot 服务器上的插件通过 /spb 命令访问 PlayerBalancer 的功能。
• 包含 PlaceholderAPI 占位符 %pb_pc_分区名%，用于获取分区内所有服务器的玩家总数。
• 此为独立资源，可在此处免费下载。

开发者 API

• 为开发者提供插件 API，可从 Spigot 端和 BungeeCord 端访问插件数据。
• 这是内置附加组件能够工作的基础。

高度兼容

• 与众多插件兼容，包括但不限于：
• Party and Friends (需附加组件)
• UltimateFriends (已集成)
• PlaceholderAPI (需附加组件)
• 任何大厅选择器插件

🎮命令

回退命令

• 功能：将玩家从其当前分区移动到其父分区的一个服务器。本质上是 /hub、/lobby 命令。
• 用法：可指定数字参数连接到特定服务器。

分区命令

• 功能：可设置为特定分区的命令，执行后玩家将连接到该分区。
• 说明：分区可包含一台或多台服务器。

插件管理命令

• 命令：/balancer
• 功能：安全重载插件，并快速将插件配置上传到 Pastebin 以便获取支持。

分区管理命令

• 命令：/section
• 功能：
• 使玩家连接到指定分区。
• 获取分区及其服务器的信息。
• 列出所有分区，并提供点击事件以增强使用体验。
• 权限：所有管理命令都需要 playerbalancer.admin 权限。

🔧配置概览

配置文件结构清晰，注释详尽。以下为关键部分摘要

通用设置 (`general`)

• enabled：配置完成后必须设置为 true。
• auto-reload：设置为 true 时，执行 /greload 将重载本插件。
• plugin-messaging：启用 Spigot 插件与本插件的通信。使用附加组件时请勿禁用。

消息 (`messages`)

• 可自定义所有提示消息，支持变量如 {section}、{server}、{alias}。
• 注释掉某条消息即可禁用它。

功能配置 (`features`)

均衡器 (`balancer`)

• 分区定义：在 sections 中定义分区层级结构。
• 提供者：支持多种服务器选择算法，如 RANDOM、PROGRESSIVE_LOWEST、RANDOM_FILLER 等。
• 主要分区：通过 principal-section 设置，对回退命令和踢出处理器等功能至关重要。
• 服务器匹配：可使用正则表达式匹配一组服务器。

服务器检查器 (`server-checker`)

• 可设置检查策略、尝试次数、间隔和超时时间。
• 通过 marker-descs 列表，可根据 MOTD 内容标记服务器为不可访问。

回退命令 (`fallback-command`)

• 可配置命令名称、权限和别名。
• 可通过 excluded-sections 排除特定分区。
• 可通过 rules 规则覆盖默认的父分区跳转行为。

踢出处理器 (`kick-handler`)

• 通过 inverted 和 reasons 列表控制踢出原因匹配逻辑（黑名单或白名单）。
• 可通过 rules 规则指定从特定分区被踢出后应前往的目标分区。

权限路由器 (`permission-router`)

• 通过 rules 定义权限与目标分区的映射关系，实现玩家重定向。

❓注意事项与支持

• 配置时请仔细阅读注释，它们非常重要。
• 遇到问题时，请通过私信提供问题描述和配置文件以获取支持。
• 可使用 /balancer paste 命令快速上传配置文件及其他相关文件。
• 如果插件加载配置有问题，请尝试在文本内容周围加上引号。
• 分区服务器启用 show-players=true 时，会显示分区内所有服务器的玩家总和，这可能导致某些插件误判 BungeeCord 的总玩家数。

⭐统计与指标

• 本插件会匿名收集服务器统计信息以用于改进，您可以通过修改 bStats 配置选择退出。
• 您可以在此处查看本插件的统计信息。

✨开发者资源

• 完整的开发者 API 文档请访问：https://playerbalancer.bghddevelopment.com/developer-api