\n# \ud83d\ude80 MultiProxySync<\/p>\n
> Solve inconsistent player counts across multiple Velocity proxies.<\/p>\n
## \ud83d\udcd6 About<\/p>\n
**MultiProxySync** is a plugin for **Velocity proxy networks** designed for multi-proxy setups that need global player count synchronization.<\/p>\n
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.<\/p>\n
Starting from newer versions, MultiProxySync also uses **Redis Pub\/Sub** to improve synchronization responsiveness.
\nWhen players join, leave, or when a proxy shuts down, other proxies can refresh their cached global player count much faster.<\/p>\n
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.<\/p>\n
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.<\/p>\n
—<\/p>\n
## \ud83d\udcf7 Preview<\/p>\n
<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* **Consistent Network-Wide Player Count**
\n Keeps the online player count more consistent across all Velocity entry points.<\/p>\n
* **Faster Count Refresh**
\n Player count changes propagate more quickly when players join, leave, or when a proxy shuts down.<\/p>\n
* **Automatic Cleanup**
\n Stale data from crashed or offline proxies is cleaned up automatically.<\/p>\n
* **MiniPlaceholders Support**
\n Automatically registers placeholder support when **MiniPlaceholders** is installed.<\/p>\n
* **Public API**
\n Exposes synchronized proxy and player data for other plugins.<\/p>\n
* **Lightweight and Practical**
\n Simple to configure and suitable for real production multi-proxy environments.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
You will need:<\/p>\n
* **Velocity** proxy server
\n* **Redis** database<\/p>\n
### Optional<\/p>\n
* **MiniPlaceholders**
\n If installed, MultiProxySync will automatically enable placeholder support.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Installation<\/p>\n
1. Download the latest `multiproxysync-plugin` release
\n2. Place it into the `plugins` folder of all your Velocity proxies
\n3. Start each proxy once to generate the configuration file
\n4. Edit the generated `config.yml`
\n5. Restart all proxy instances<\/p>\n
—<\/p>\n
## \ud83d\udcc4 Configuration Example<\/p>\n
“`yaml
\nplugin:
\n serverName: Proxy-01
\n enabled: true<\/p>\n
redis:
\n host: 127.0.0.1
\n port: 6379
\n password: YourPassword
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd24 Placeholder<\/p>\n
If **MiniPlaceholders** is installed, MultiProxySync will automatically register the following placeholder:<\/p>\n
“`text This placeholder returns the synchronized total player count of the whole proxy network.<\/p>\n —<\/p>\n ## \u26a0\ufe0f Notes<\/p>\n * Every proxy node must use a unique `serverName` —<\/p>\n ## \ud83d\udd27 For Developers<\/p>\n MultiProxySync also provides a public API for plugin integrations.<\/p>\n If you want to use the API in your own plugin, please check the documentation on GitHub:<\/p>\n https:\/\/github.com\/User-Time\/MultiProxySync<\/p>\n —<\/p>\n ## \ud83d\udcac Feedback<\/p>\n If you run into any issues or have ideas for improvement, feedback is always welcome.<\/p>\n","protected":false},"excerpt":{"rendered":" Solve inconsistent player counts across multiple Velocity proxies.<\/p>\n","protected":false},"featured_media":107589,"template":"","meta":{"_minecraft_slug":"multiproxysync","_minecraft_project_id":"kNCfAF9Y","_minecraft_author":"User-Time","_minecraft_license":"Apache-2.0","_minecraft_downloads":59,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"multiproxysync.zip","_minecraft_size_bytes":5594499,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T20:48:39.230188Z","_minecraft_date_created":"2026-03-17T02:20:16.751245Z","_minecraft_date_modified":"2026-04-23T04:19:48.897289Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/multiproxysync","_minecraft_icon_attachment_id":107589,"_minecraft_imported_at":"2026-06-06T05:14:10+00:00","_minecraft_import_hash":"db535bd5b764a3651db7d1826bdd2969","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,126,90,867,92,985],"mod_loader":[986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-107588","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-management","mod_category-optimization","mod_category-social","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n
\n“`<\/p>\n
\n* All proxy nodes must connect to the same Redis instance
\n* The plugin is disabled by default until `enabled: true` is set in the config<\/p>\n