原创 开源 MultiProxySync | Velocity 群组服 / 多代理玩家数同步插件 v2.2.0

MultiProxySync
Velocity 群组服 / 多代理服的全网玩家数同步插件​

MultiProxySync

专为 Velocity 群组服、多代理服务器网络 设计的同步插件。

如果你的网络使用了多个 Velocity 代理，
并且希望服务器列表、MOTD 以及不同入口显示的玩家人数尽可能保持一致，
那么这个插件就是为这种场景准备的。

插件通过 Redis
在多个代理之间同步全网玩家数量与玩家列表，
用于改善多代理环境下玩家人数不同步、
不同入口显示不一致等问题。

在 2.2.0 版本中，
插件进一步加入了 Redis Pub/Sub 实时刷新机制，
当玩家加入、离开，或代理关闭时，
其他代理能够更快刷新本地缓存的全网人数。

此外，插件还提供 公共 API，
并支持 MiniPlaceholders 占位符，
方便其他插件或显示系统接入同步后的全网人数数据。

​

​

多代理同步
在多个 Velocity 代理之间同步玩家人数与玩家列表

更及时的人数刷新
玩家加入、离开或代理关闭后，其他代理能更快刷新全网人数

更一致的全网显示
让不同入口、服务器列表与 MOTD 显示更接近真实全网在线人数

自动清理异常数据
代理异常掉线后可自动清理残留数据，减少假在线与统计错误

公共 API + 占位符支持
支持其他插件读取同步数据，并可配合 MiniPlaceholders 显示全网人数
​

运行环境

Velocity 服务端
Redis 数据库

可选：MiniPlaceholders（用于占位符支持）
​

下载最新版本的 multiproxysync-plugin
将插件放入 Velocity 的 plugins 文件夹
启动服务器一次，插件会自动生成配置文件
关闭服务器并编辑配置文件
​

打开生成的配置文件并填写 Redis 信息，例如：


配置完成后重新启动服务器即可。
​

若服务器安装了 MiniPlaceholders，
插件会自动注册以下占位符：


该占位符可用于显示当前同步后的全网在线人数。
​

本插件提供公共 API，
可供其他 Velocity 插件读取同步后的全网玩家数据。

可获取内容包括：

所有代理节点
全网玩家列表
按代理分组的玩家列表
全网总人数
各代理人数统计

开发者可通过 Maven Central 引入 API，
详细说明可前往 GitHub 项目主页查看。
​

插件需要 Redis 才能正常运行
所有代理服应连接到同一个 Redis 实例
每个代理节点都必须使用不同的 serverName

插件 默认处于关闭状态
需要在配置文件中手动启用并填写数据库信息
​

在使用过程中遇到任何问题，
欢迎在 Issues 中提交反馈。
​