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

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

​

MultiProxySync

专为 Velocity 群组服 / 多代理服务器网络 设计。

插件通过 Redis
在多个 Velocity 代理之间同步玩家人数与玩家列表，
使不同代理服务器入口能够共享一致的全局在线人数和玩家状态。

MultiProxySync 结合周期同步、Redis Pub/Sub
以及代理节点健康检测，
在代理服务器重启、断开或异常崩溃时，
仍能尽可能保持同步数据准确。

如果你的服务器网络拥有多个 Velocity 入口，
并希望服务器列表、MOTD 以及其他插件读取到的全网在线人数保持一致，
MultiProxySync 就是为这种使用场景设计的。
​

​

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

Redis Pub/Sub
玩家加入、离开或代理状态变化时，
快速通知其他代理刷新同步数据

统一在线人数
接管 ProxyPingEvent，
让不同服务器入口显示一致的全网在线人数

代理服状态检测
基于 Redis ZSET 记录代理心跳，
自动识别并清理失效代理节点

Redis 时间戳
心跳使用 Redis 服务器时间，
避免不同代理服务器系统时钟偏差影响状态判断

公共 API
为其他插件提供只读的代理节点、玩家列表与人数数据

MiniPlaceholders
支持通过占位符显示同步后的全网在线人数

bStats
提供匿名使用统计及代理网络规模统计

更新提醒
启动时自动检查 GitHub Releases，
发现新版本后在控制台输出提醒
​

代理服务器启动后会自动注册到 Redis。

超过 30 秒
未更新心跳的代理服务器将被视为离线，
并从当前有效代理列表中自动清理。

心跳时间戳由 Redis 服务器时间 提供，
避免不同服务器系统时间存在偏差时影响代理状态判断。
​

运行环境

Velocity 3.0.0+
Redis 数据库

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

一个可用的 Redis 服务器

下载最新版 multiproxysync-plugin

将插件放入所有 Velocity 代理服务器的
plugins 文件夹

启动服务器并编辑生成的 config.yml

确保所有 MultiProxySync 实例
连接到同一个 Redis 服务器
​

serverName 在每个代理服务器中必须保持唯一。

enabled 用于控制 MultiProxySync 是否启用。

所有代理服务器必须连接到同一个 Redis 实例。
​

安装 MiniPlaceholders 后，
MultiProxySync 会自动注册：


例如：


该占位符返回当前同步的全网在线人数。
​

MultiProxySync 提供公共 API，
可供其他 Velocity 插件读取同步后的代理与玩家数据。

开发者可直接通过 Maven Central 引入 API。

GitHub API 文档
​

2.3.0+：基础功能维护

2.3.0+ 将继续专注于
玩家人数和玩家列表同步。

后续版本主要围绕现有功能进行
维护、Bug 修复和稳定性改进，
不再增加非必要功能。

如有必要，
仍可能通过小版本更新加入
与基础同步功能直接相关的改进。

3.0.0+：功能拓展

从 3.0.0 开始，
MultiProxySync 将在现有玩家同步功能基础上
拓展更多功能。

如果你只需要玩家人数和玩家列表同步，
可以继续使用 2.3.x 系列；

如果希望使用后续拓展功能，
可以选择 3.0.0+。
​

插件必须连接 Redis 才能正常工作

所有代理服务器应连接到同一个 Redis 实例

每个代理服务器必须使用不同的 serverName

插件默认不会启用，
需要在配置文件中设置：

代码：

enabled: true

​

使用过程中遇到问题或有新的建议，
欢迎前往 GitHub 提交反馈。

GitHub Issues

GitHub 项目主页

Modrinth
​