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, SQLite db, or our 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 or the same account (on Whitelist Sync Web)!

New in v2.7.0

• Added support for syncing banned players and IPs to the database. (Only supported when using the Whitelist Sync web service)
• Removed old whitelist sync commands. Normal Minecraft commands can be used now and the mod will update the database accordingly. (Use /wl sync to pull from the database and /wl push to push to the database still)
• Added support for new Web Service database option (currently in beta). See Whitelist Sync Web for details.

New in v2.5.0

• No more shadowed JDBC dependencies! MANUAL STEP REQUIRED for v2.5.0. See Installation section below.
• copyServerToDatabase commands have been changed to push.

Download

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

Support the project

If you like this project and want to support it, consider donating to my PayPal, buymeacoffee or using the new Whitelist Sync Web service! Any amount is appreciated!

Supported Versions

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

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

For Web Sync (Recommended, easiest setup, paid service):

• Create login to Whitelist Sync Web and create an account/group for your servers.
• On the account, click manage. You will see a section for API keys. Create an API key and copy the GUID.
• Download this mod and add the jar file to your mods folder.
• Run your server once and set up the config (whitelistsync.cfg/whitelistsync-common.toml located in the config folder).
• Set the database type to "WEB" and paste the GUID into the API key field. Adjust other settings as needed.
• Run the server and make sure it connects to the web service.
• All done! You can now manage all your servers from the Whitelist Sync Web interface in real-time!

For SQLite database config (Self-hosted):

• Download this mod AND the SQLite DB connector mod and add both jar files 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 (Self-hosted):

• Download this mod AND the MySQL DB connector mod and add both jar files 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!

Commands (v2.7.0 and above)

• /wl sync | Refreshes local synced data from database.
• /wl push | Pushes local server data to the database. Use this if you want to update the database with the current server data.

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 database and will update the local server whitelist and ops list accordingly. The polling interval can be set in the config file.

To-Do

• Get the damn gradle project structure to work
• Allow user to sync/push only whitelist, ops, or bans

Future Plans

• Add support for syncing ban lists
• Add support for Fabric
• Add support for BungeeCord
• Add support for Spigot
• Add support for Paper

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