MultiProxySync

🚀 MultiProxySync

> Solve inconsistent player counts across multiple Velocity proxies.

📖 About

Velocity proxy networks 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 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:

* Redis 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

```yaml 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:

```text <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.