🚀 MultiProxySync

Name: MultiProxySync
Author: User-Time

用于解决多个 Velocity 代理之间在线人数显示不一致的问题。

📖 介绍

MultiProxySync 是一款适用于 Velocity 多代理架构 的插件，主要用于在多个代理节点之间同步玩家人数和玩家列表。

它通过 Redis 在各个代理之间共享数据，让玩家无论从哪个代理入口进入，都能看到更一致、更准确的在线人数显示。

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

如果你的服务器使用了多个 Velocity 代理，并且希望服务器列表中的在线人数在不同入口下都能保持同步，那么这个插件就是为这种场景准备的。

它特别适合用于以下情况：
不同代理显示的在线人数不一致、人数同步不及时，或者多个代理对外显示的玩家数量经常对不上。

📷 预览

Image displaying server MOTD information

✨ 功能特点

多代理人数同步
在多个 Velocity 代理之间同步玩家人数和玩家列表。
人数刷新更及时
当玩家加入、离开或代理关闭时，其他代理能更快刷新全网人数显示。
人数显示更准确
尽量保证不同入口看到的在线人数保持一致。
基于 Redis 共享数据
通过 Redis 在各代理节点之间传递和同步数据。
自动清理过期数据
当某个代理异常掉线或崩溃时，遗留的旧数据会被自动清理。
MiniPlaceholders 支持
安装 MiniPlaceholders 后可自动启用占位符支持。
公开 API
可供其他插件读取同步后的全网玩家与代理数据。
轻量简单
配置清晰，适合实际环境使用。

📦 运行要求

你需要准备：

Velocity 代理端
Redis 数据库

可选

MiniPlaceholders
如果安装，插件会自动启用占位符支持。

🛠️ 安装方法

下载最新版本的 multiproxysync-plugin
将它放入所有 Velocity 代理的 plugins 文件夹中
启动每个代理一次，生成配置文件
编辑生成的 config.yml
重启所有代理实例

📄 配置示例

plugin:
  serverName: Proxy-01
  enabled: true

redis:
  host: 127.0.0.1
  port: 6379
  password: YourPassword

🔤 占位符

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

<multiproxysync_global_player_count>

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

⚠️ 注意事项

每个代理节点都必须使用不同的 serverName
所有代理节点都必须连接到同一个 Redis 实例
插件默认不会启用，需要在配置中将 enabled 设为 true

🔧 给开发者

MultiProxySync 同时提供了公开 API，方便其他插件进行对接。

如果你想在自己的插件中使用它的 API，可以前往 GitHub 查看相关说明：

https://github.com/User-Time/MultiProxySync

💬 反馈

如果你在使用中遇到问题，或者有功能建议，欢迎反馈。

MultiProxySync