🚀 MultiProxySync

Solve inconsistent player counts across multiple Velocity proxies.

📖 About

MultiProxySync is a plugin for Velocity proxy networks designed for multi-proxy setups that need global player count synchronization.

It uses Redis to synchronize player counts and player lists between multiple proxy nodes, so your whole network can show a more consistent and accurate online player count.

Starting from newer versions, MultiProxySync also uses Redis Pub/Sub to improve synchronization responsiveness.
When players join, leave, or when a proxy shuts down, other proxies can refresh their cached global player count much faster.

If your network uses more than one Velocity proxy and you want the player count shown in the server list to stay in sync across all entry points, this plugin is made for that situation.

It is especially useful if your proxies show different online numbers, player counts are not syncing correctly, or the number of players appears inconsistent across multiple proxy servers.

---

📷 Preview

---

✨ Features

• Consistent Network-Wide Player Count
  Keeps the online player count more consistent across all Velocity entry points.

• Faster Count Refresh
  Player count changes propagate more quickly when players join, leave, or when a proxy shuts down.

• Automatic Cleanup
  Stale data from crashed or offline proxies is cleaned up automatically.

• MiniPlaceholders Support
  Automatically registers placeholder support when MiniPlaceholders is installed.

• Public API
  Exposes synchronized proxy and player data for other plugins.

• Lightweight and Practical
  Simple to configure and suitable for real production multi-proxy environments.

---

📦 Requirements

You will need:

• Velocity proxy server
• Redis database

Optional

• MiniPlaceholders
  If installed, MultiProxySync will automatically enable placeholder support.

---

🛠️ Installation

1. Download the latest multiproxysync-plugin release
2. Place it into the plugins folder of all your Velocity proxies
3. Start each proxy once to generate the configuration file
4. Edit the generated config.yml
5. Restart all proxy instances

---

📄 Configuration Example

plugin:
  serverName: Proxy-01
  enabled: true

redis:
  host: 127.0.0.1
  port: 6379
  password: YourPassword

---

🔤 Placeholder

If MiniPlaceholders is installed, MultiProxySync will automatically register the following placeholder:

<multiproxysync_global_player_count>

This placeholder returns the synchronized total player count of the whole proxy network.

---

⚠️ Notes

• Every proxy node must use a unique serverName
• All proxy nodes must connect to the same Redis instance
• The plugin is disabled by default until enabled: true is set in the config

---

🔧 For Developers

MultiProxySync also provides a public API for plugin integrations.

If you want to use the API in your own plugin, please check the documentation on GitHub:

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

---

💬 Feedback

If you run into any issues or have ideas for improvement, feedback is always welcome.