
? MultiProxySync
在多个 Velocity 代理服务器之间同步玩家数量和玩家列表。
? 简介
MultiProxySync 专为分布式 Velocity 代理网络设计。
它使用 Redis 来保持多个 Velocity 代理服务器之间的玩家数量、玩家列表和代理状态同步,使每个入口点都能共享整个网络的在线数据。
通过定期同步和 Redis Pub/Sub,玩家和代理状态的更改可以实时同步,同时自动检测并移除不活跃的代理服务器。
? 预览

✨ 特性
-
多代理玩家同步
在多个 Velocity 代理服务器之间同步玩家数量和玩家列表,并保持更新。
-
一致的全局玩家计数
在不同代理入口点之间同步全网的在线人数,并保持数据一致。
-
Redis Pub/Sub
以毫秒级速度同步玩家加入、离开以及代理状态更改,实时更新数据。
-
自动代理检测
自动检测活跃和不活跃的代理服务器,并保持代理列表的更新。
-
MiniPlaceholders 支持
安装后自动通过 MiniPlaceholders 提供同步后的全局玩家数量。
-
更新检查器 & bStats
检查新版本并收集匿名使用统计信息。
? 依赖项
可选
?️ 安装
- 搭建 Redis 服务器。
- 下载最新的
multiproxysync-plugin。
- 将其放入每个 Velocity 代理服务器的
plugins 目录中。
- 启动代理服务器并编辑生成的
config.yml。
- 确保所有 MultiProxySync 实例都连接到同一个 Redis 服务器。
? 配置
plugin:
serverName: Proxy-01
enabled: true
redis:
host: 127.0.0.1
port: 6379
password: YourPassword
注意事项
serverName 对于每个代理必须是唯一的。
- 所有代理必须连接到同一个 Redis 实例。
enabled 控制是否初始化 MultiProxySync。
? MiniPlaceholders
当安装了 MiniPlaceholders 时,MultiProxySync 会自动注册:
<multiproxysync_global_player_count>
示例:
Global online: <multiproxysync_global_player_count>
该占位符返回同步后的全网在线玩家数量。
?️ 版本路线图
2.3.x
2.3.x 发布线专注于玩家数量和玩家列表的同步。
未来的 2.3.x 版本将主要包含与现有同步功能相关的错误修复、稳定性改进和维护。
3.0.0+
从 3.0.0 开始,MultiProxySync 将超越玩家同步,引入额外的网络同步功能。
如果您只需要玩家数量和玩家列表同步,可以继续使用该 2.3.x 发布线。
? 开发者信息
MultiProxySync 提供了一个只读 API,用于访问同步的代理和玩家数据。
从 2.3.0 开始,API 使用:
Maven Group ID: net.time-cloud
Java Package: net.timecloud
API 方法签名与之前版本保持一致。
有关依赖示例和使用文档,请参阅 GitHub 仓库:
? 反馈
如果遇到任何问题或有建议,欢迎提供反馈:

? MultiProxySync
Synchronize player counts and player lists across multiple Velocity proxies.
? About
MultiProxySync is designed for distributed Velocity proxy networks.
It uses Redis to keep player counts, player lists, and proxy states synchronized across multiple Velocity proxies, allowing every entry point to share the same network-wide online data.
With periodic synchronization and Redis Pub/Sub, player and proxy state changes are synchronized in real time while inactive proxies are automatically detected and removed from the active proxy list.
? Preview

✨ Features
-
Multi-Proxy Player Sync
Synchronizes player counts and player lists across multiple Velocity proxies and keeps them up to date.
-
Consistent Global Player Count
Synchronizes the network-wide online count across different proxy entry points and keeps it consistent.
-
Redis Pub/Sub
Synchronizes player join, leave, and proxy state changes in milliseconds and keeps data updated in real time.
-
Automatic Proxy Detection
Automatically detects active and inactive proxies and keeps the proxy list up to date.
-
MiniPlaceholders Support
Automatically provides the synchronized global player count through MiniPlaceholders when installed.
-
Update Checker & bStats
Checks for new versions and collects anonymous usage statistics.
? Requirements
Optional
?️ Installation
- Set up a Redis server.
- Download the latest
multiproxysync-plugin.
- Place it in the
plugins directory of every Velocity proxy.
- Start the proxies and edit the generated
config.yml.
- Make sure every MultiProxySync instance connects to the same Redis server.
? Configuration
plugin:
serverName: Proxy-01
enabled: true
redis:
host: 127.0.0.1
port: 6379
password: YourPassword
Notes
serverName must be unique for each proxy.
- All proxies must connect to the same Redis instance.
enabled controls whether MultiProxySync is initialized.
? MiniPlaceholders
When MiniPlaceholders is installed, MultiProxySync automatically registers:
<multiproxysync_global_player_count>
Example:
Global online: <multiproxysync_global_player_count>
The placeholder returns the synchronized network-wide online player count.
?️ Version Roadmap
2.3.x
The 2.3.x release line focuses exclusively on player count and player list synchronization.
Future 2.3.x releases will mainly include bug fixes, stability improvements, and maintenance related to the existing synchronization functionality.
3.0.0+
Starting with 3.0.0, MultiProxySync will expand beyond player synchronization and introduce additional network synchronization features.
If you only need player count and player list synchronization, you can continue using the 2.3.x release line.
? For Developers
MultiProxySync provides a read-only API for accessing synchronized proxy and player data.
Starting with 2.3.0, the API uses:
Maven Group ID: net.time-cloud
Java Package: net.timecloud
API method signatures remain unchanged from previous versions.
For dependency examples and usage documentation, see the GitHub repository:
? Feedback
If you encounter an issue or have a suggestion, feedback is welcome:
评论 0
登录后参与评分
还没有评论,来抢沙发吧