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

        

  

🚀 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 信息
  

例如：

1. plugin:
   
2.   serverName: Proxy-01  # 此处服务器名称不可重复
   
3.   enabled: true  # 设为 true 后启用插件
   
4. 
   
5. redis:
   
6.   host: 127.0.0.1
   
7.   port: 6379
   
8.   password: YourPassword

复制代码

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

---

🔤 占位符支持

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

1. <multiproxysync_global_player_count>

复制代码

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

---

🔌 公共 API

  本插件现已提供公共 API，  可供其他 Velocity 插件读取同步后的全网玩家数据。
可获取内容包括：

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

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

---

❗ 注意事项

插件须使用 Redis 才能正常运行
所有代理服应连接至同一数据库
每个代理节点都必须使用不同的 serverName
插件默认处于关闭状态
需要在配置文件中手动开启并配置数据库

---

💬 反馈与支持


  如果您在使用过程中遇到任何问题或您有更好的建议，欢迎您前往 Issues 中提交反馈。

---