ModListChecker

🔒 ModListChecker

ModListChecker is a server-client mod designed to ensure that all players joining a server are using the exact same set of mods.

📖 Full documentation & setup guide: github.com/JosefWasTaken/ModListChecker

⚙️ Features

• ✅ Automatically sends the player's mod list from client to server
• ✅ Server compares the received mod list with a predefined allowed list
• ✅ Detects missing, extra, or mismatched mods
• ✅ Instantly prevents players with incorrect mod setups from joining
• ✅ Designed to work as a single mod for both client and server

🚀 Quick Setup

1. Install the mod on both server and client
2. Start the server once to generate config/modlistchecker-server.toml
3. Edit the config file and add your allowed mod IDs
4. Restart the server

For detailed installation instructions, visit the GitHub README.

🎮 How it works

When a player connects to a server:

1. The client sends its full mod list to the server
2. The server checks it against its allowed mod list
3. If everything matches → the player joins normally
4. If there is any mismatch → the player is kicked from the server

💡 Why use this mod?

Managing modpacks on multiplayer servers can be frustrating:

• Players may forget to install a required mod
• Some players might use extra mods (e.g. cheats or unfair advantages)

ModListChecker solves all of this automatically.

🚀 What players experience

• ✔️ Fair and consistent gameplay for everyone
• ✔️ No more "it works on my side" issues
• ✔️ Faster troubleshooting (clear mismatch detection)
• ✔️ Better stability on modded servers

If a player tries to join with the wrong setup, they are immediately notified by being disconnected — ensuring the server always runs exactly as intended.

🛠️ Use cases

• Modded SMP servers
• Private servers with friends
• Streamer/community servers
• Competitive environments where fairness matters