Whitelist Sync 2
by PotatoDotJar
Whitelist Sync 2 keeps the whitelists, operator lists and ban lists of several servers aligned through one shared self-hosted database.
What it does
The mod reads and writes the server whitelist, the ops list, banned players and banned IP addresses. Several Minecraft servers can point at one MySQL or SQLite database, so a change made on one server reaches the others. A companion Whitelist Sync Web service is available for those who prefer a hosted option, and its subscribers take priority over the self-hosted database when both are in use.
Setup starts by placing the mod in the mods folder and running the server once to create its configuration file, whitelistsync.cfg or whitelistsync-common.toml, in the config folder. The database address, port and authentication go in that file, along with the sync timer. Existing whitelists can be pushed to the database with copyServerToDatabase, and the mod then polls the database at an interval set in the config to pull changes. Fabric API is required, and the mod supports servers running in offline mode.
Whitelist Sync 2 is server-side only, so players join without installing anything. It is released under the GNU General Public License v3.0 only, is open source, and is published for Fabric, Forge and NeoForge with files for 1.12.2 and 1.16.5 – 26.2. The 1.12.2 line is no longer supported, and versions before 1.16.5 are handled only on request.
Key features
Shared ban lists
Banned players and banned IP addresses are synced across every server that connects to the same database.
Operator list sync
The ops list is kept in step between servers, so an operator added once is recognized everywhere.
Polling updates
Local whitelists and ops lists refresh by polling the database at a configurable interval.
Existing whitelist import
A current server whitelist can be pushed into the database with copyServerToDatabase, then pulled back into other servers.
Compatibility
Latest build for each game version and loader.
26.x2 of 2 versions with builds
1.21.x12 of 12 versions with builds
1.20.x3 of 3 versions with builds
1.19.x2 of 2 versions with builds
1.18.x1 of 1 version with builds
1.16.x1 of 1 version with builds
1.12.x1 of 1 version with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Questions
Does Whitelist Sync 2 need Fabric API?
Do players need to install Whitelist Sync 2?
Can servers run in offline mode?
In the catalog
Whitelist Sync 2 is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,894 mods support Minecraft 26.2.
Similar mods
What the author says
Are you a server owner who is sick of adding individual players to each of your 100 forge servers? Wait you only have 2 forge servers? Well this mod can help you still! Versions not listed above and before 1.16.5 can be requested as an issue. I will try my best to accommodate. Whitelist Sync Web subscribers take…
Official listing
- Modrinth page
- modrinth.com/mod/whitelistsync2
- Owner
- PotatoDotJar
- Published
- 2022-10-29
- Updated on Modrinth
- 2026-07-07
- Facts verified
- 2026-10-15
