MultiProxySync | Velocity 群组服 / 多代理玩家数同步插件
本帖最后由 User.Time 于 2026-4-23 12:53 编辑🚀 MultiProxySync 🚀
Velocity 群组服 / 多代理服的全网玩家数同步插件
📖 插件介绍
一款专为 Velocity 群组服、多代理服务器网络 设计的同步插件。
如果你的网络使用了多个 Velocity 代理，并且希望服务器列表、MOTD 以及不同入口显示的玩家人数尽可能保持一致，那么这个插件就是为这种场景准备的。
该插件通过 Redis在多个代理服务器之间同步全网玩家数量与玩家列表，用于改善群组服环境下玩家人数不同步、在线人数不一致，或不同代理显示人数不准确的问题。
在 2.2.0 版本中，插件进一步加入了 Redis Pub/Sub 实时刷新机制，当玩家加入、离开，或代理关闭时，其他代理能够更快刷新本地缓存的全网人数。
此外，插件还提供公共 API，并支持 MiniPlaceholders 占位符，方便其他插件或显示系统接入同步后的全网人数数据。
📷 插件效果展示
✨ 插件特色
[*]🔄 多代理同步：支持多个 Velocity 代理之间同步玩家人数与玩家列表
[*]⚡ 更及时的人数刷新：玩家加入、离开或代理关闭后，其他代理能更快刷新全网人数
[*]📊 更一致的全网显示：让不同入口、服务器列表与 MOTD 显示更接近真实全网在线人数
[*]🧹 自动清理异常数据：代理异常掉线后，会自动清理残留数据，减少假在线与统计错误
[*]🔌 公共 API + 占位符支持：支持其他插件读取同步数据，并可配合 MiniPlaceholders 显示全网人数
📦 运行环境 📦
Velocity 服务端Redis 数据库MiniPlaceholders（可选）
📦 安装与配置
1️⃣ 安装插件
[*]下载最新版本的 multiproxysync-plugin
[*]将插件放入 Velocity 的 plugins 文件夹
[*]启动服务器一次，插件会自动生成配置文件
[*]关闭服务器并编辑配置文件
2️⃣ 配置插件配置文件
[*]打开生成的配置文件并填写 Redis 信息
例如：
plugin:
serverName: Proxy-01# 此处服务器名称不可重复
enabled: true# 设为 true 后启用插件
redis:
host: 127.0.0.1
port: 6379
password: YourPassword
配置完成后重新启动服务器即可。
🔤 占位符支持
如果服务器安装了 MiniPlaceholders，插件会自动注册以下占位符：
<multiproxysync_global_player_count>
该占位符可用于显示当前同步后的全网在线人数。
🔌 公共 API
本插件现已提供公共 API，可供其他 Velocity 插件读取同步后的全网玩家数据。
可获取内容包括：
[*]所有代理节点
[*]全网玩家列表
[*]按代理分组的玩家列表
[*]全网总人数
[*]各代理人数统计
开发者可通过 Maven Central 引入 API，详细说明可前往 GitHub 项目主页查看。
❗ 注意事项
插件须使用 Redis 才能正常运行
所有代理服应连接至同一数据库
每个代理节点都必须使用不同的 serverName
插件默认处于关闭状态
需要在配置文件中手动开启并配置数据库
💬 反馈与支持
如果您在使用过程中遇到任何问题或您有更好的建议，欢迎您前往 Issues 中提交反馈。
页: [1]