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):

• See the Whitelist Sync Web setup on the dedicated page

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)

The mod uses polling to check for changes in the self-hosted databases and will update the local server whitelist and ops list accordingly. The polling interval can be set in the config file.

Please post your bugs to GitHub or better yet make a pull request!