SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedAdmin & protection

Whitelist Sync 2

by PotatoDotJar · for Minecraft

A mod that allows you to sync the whitelists, ops list, banned players (Web only), and banned IPs (Web only) from multiple Minecraft servers together using one MySQL db, SQLite db, or our NEW Whitelist Sync Web service!

4.8KDownloads
31d agoLast updated
GPL-3.0-onlyLicense
Fabric · Forge +1Loaders

About Whitelist Sync 2

From Modrinth

A mod that allows you to sync the whitelists, ops list, banned players (Web only), and banned IPs (Web only) from multiple Minecraft servers together using one MySQL db, SQLite db, or our NEW Whitelist Sync Web service!

_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!_

Introducing Whitelist Sync! ===========================

A mod that allows you to sync the whitelists, ops list, banned players (Web only), and banned IPs (Web only) from multiple Minecraft servers together using one MySQL db, PostgreSQL db, SQLite db, or the NEW Whitelist Sync Web service!

This mod listens for whitelist, op, ban, and ban-ip changes (using the normal Minecraft commands) on all of your servers and will update all other forge servers connected to the same database.

Whitelist Sync Web

Whitelist Sync Web is a new service that allows you to sync your whitelist, ops, banned players, and banned IPs across all of your servers in real-time. This service is a paid service, but it does have a free tier for you to try out. This service is the easiest way to sync your servers and requires no setup on your end other than installing the mod and setting the API key. Interested in learning more? Click here.

Support the project

If you like this project and want to support it, consider donating using this link. Any amount is appreciated!

Download

All releases can be found on the Modrinth page or on CurseForge.

Support/Questions/Feedback

For issues with the mod please open an issue on GitHub. For other support requests, feature requests, or other general discussion. Please join the Discord Server.

Supported Forge Versions

  • 1.21.3
  • 1.21.1
  • 1.21
  • 1.20.6
  • 1.20.2
  • 1.20.1
  • 1.19.2
  • 1.19
  • 1.18.2
  • 1.16.5
  • ~~1.12.2~~ (no longer supported, may come back in the future)

Supported Fabric Versions

  • 26.3
  • 26.2
  • 26.1.2
  • 1.21.11
  • 1.21.10
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21
  • 1.20.1

Supported NeoForge Versions

  • 26.3
  • 26.2
  • 26.1.2
  • 1.21.11
  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.1
  • 1.21

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 priority.

Installation

Note: This mod does not support servers running in offline mode.

For Web Sync (Recommended, easiest setup):

For SQLite database config (Requires self-hosted SQLite database):

  • Download this mod and add it to your mods folder.
  • Run your server once and set up the config (whitelistsync.cfg/whitelistsync-common.toml located in the config folder) and configure your database settings and timers.
  • NOTE: Be sure to make the database path the same for all the servers you want to link together!
  • When the server runs it is going to make a new database unless one already exists. If you want to push your current whitelist to the new database use "/wl copyServerToDatabase" then you can start all of your other servers and they will sync to the database.

For MySQL database (Requires self-hosted MySQL database):

  • Download this mod and add it to your mods folder.
  • Run your server once and set up the config (whitelistsync.cfg/whitelistsync-common.toml located in the config folder) and configure your database settings and timers.
  • Set up your mySQL database IP, port, and authentication as well as the Sync Timer.
  • Run server and make sure the database connects. Note: Mod will make its own database and table for you or connect to an existing one.
  • Push your existing whitelist to the server (/wl copyServerToDatabase) or pull changes from your database (/wl sync).
  • Enjoy!

For PostgreSQL database (Requires self-hosted PostgreSQL database):

  • Set databaseMode = "POSTGRESQL" and fill in the [postgresql] section of the config (IP, port, database name, schema, username, password).
  • Note: The database itself must already exist. The mod creates the schema and tables for you.
  • Push your existing whitelist to the database (/wl copyServerToDatabase) or pull changes (/wl sync).

Commands

  • /wl sync [whitelist|ops|banned-players|banned-ips] | Refreshes local synced data from database.
  • /wl push [whitelist|ops|banned-players|banned-ips] | Pushes local server data to the database. Use this if you want to update the database with the current server data.
  • /wl restart | Restarts the sync thread. Useful if the sync thread stops or has issues.

Legacy Commands (For v2.6.0 and below ONLY!)

Whitelist Control

  • /wl add <player> | Adds a specified player to whitelist. (Use this instead of /whitelist add)
  • /wl remove <player> | Removes a specified player from the whitelist. (Use this instead of /whitelist remove)
  • /wl list | Lists users whitelisted across all servers.
  • /wl sync | Pulls whitelist from the database and updates the local server whitelist.
  • /wl push | Pushes local server whitelist to the database and merges them in. (Versions before v1.5.0 use /wl copyServerToDatabase)

Op Control

  • /wlop op <player> | Ops a specified player. (Use this instead of /op)
  • /wlop deop <player> | De-ops a specified player. (Use this instead of /deop)
  • /wlop list | Lists users who are ops across all servers.
  • /wlop sync | Pulls list of ops from the database and updates local server ops.
  • /wlop push | Pushes local server ops to database and merges them in. (Versions before v1.5.0 use /wlop copyServerToDatabase)

Read the full description on Modrinth →

Highlights

From source data

Game versions

Supports 23 Minecraft versions, the newest being 26.3.

Loaders

Runs on Fabric, Forge and NeoForge.

Footprint

Rated a light load on a server.

Whitelist Sync 2 on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Required on the server
Server type needed
Fabric, Forge, NeoForge
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
26.3-2.10.0, released 2026-10-22

Game versions by loader

LoaderGame versionsNewest
NeoForge1.21.10 to 26.3 (5 versions)26.3
Fabric1.21.1 to 1.21.11 (3 versions)1.21.11

From 10 recorded builds of Whitelist Sync 2.

Recent builds

BuildReleasedGame versionsLoaders
26.3-2.10.02026-10-2226.3NeoForge
26.2-2.10.02026-10-2226.2NeoForge
26.1.2-2.10.02026-10-2226.1.2NeoForge
1.21.11-2.10.02026-10-221.21.11NeoForge
1.21.10-2.10.02026-10-221.21.10NeoForge
1.21.1-2.9.02026-07-071.21.1Fabric

Dependencies

  • Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run Whitelist Sync 2 on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

Modrinth lists Whitelist Sync 2 as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
FabricForgeNeoForge
Runs on
Serverrequired on the server
Game versions
26.3 and 22 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-22Open ↗
  • ✓AuthorPotatoDotJar, as published on Modrinth
  • ✓LicenseGPL-3.0-onlyFree

Whitelist Sync 2, answered

Generated from the mod’s own source data.

Do my players need to install Whitelist Sync 2?

Modrinth lists Whitelist Sync 2 as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric, Forge and NeoForge.

Is it free?

Yes. Whitelist Sync 2 is free to download from Modrinth. Its license is GPL-3.0-only.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Whitelist Sync 2 on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Whitelist Sync 2 in one click.