ModsFinder

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.

FabricForgeNeoForgeServer-side onlyGNU General Public License v3.0 onlyOpen source1.12.2 – 26.2

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

  1. Shared ban lists

    Banned players and banned IP addresses are synced across every server that connects to the same database.

  2. Operator list sync

    The ops list is kept in step between servers, so an operator added once is recognized everywhere.

  3. Polling updates

    Local whitelists and ops lists refresh by polling the database at a configurable interval.

  4. 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
26.226.2-2.9.0Not available26.2-2.9.0
26.1.226.1.2-2.9.0Not available26.1.2-2.9.0
1.21.x12 of 12 versions with builds
1.21.111.21.11-2.9.0Not available1.21.11-2.9.0
1.21.101.21.10-2.9.0Not available1.21.10-2.9.0
1.21.9Not availableNot available1.21.9-2.9.0
1.21.81.21.8-2.9.0Not available1.21.8-2.9.0
1.21.71.21.7-2.9.0Not availableNot available
1.21.61.21.6-2.9.0Not availableNot available
1.21.51.21.5-2.9.0Not available1.21.5-2.9.0
1.21.41.21.4-2.9.0Not available1.21.4-2.9.0
1.21.31.21.3-2.9.01.21.3-2.8.11.21.3-2.9.0
1.21.21.21.2-2.9.0Not availableNot available
1.21.11.21.1-2.9.01.21.1-2.8.11.21.1-2.9.0
1.211.21-2.9.01.21-2.8.11.21-2.9.0
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
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Questions

Does Whitelist Sync 2 need Fabric API?

Yes. Fabric API is listed as a required dependency, so it must be installed alongside the mod on Fabric servers.

Do players need to install Whitelist Sync 2?

No. Players join without it, since only the server has to run the mod.

Can servers run in offline mode?

Yes, the mod supports servers running 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…
PotatoDotJar, on the Modrinth page

Official listing

Owner
PotatoDotJar
Published
2022-10-29
Updated on Modrinth
2026-07-07
Facts verified
2026-10-15

Tags