ModListChecker
This mod checks the allowed mod list and compares it to the player's one, if it's not the same player gets kicked out.
🔒 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
- Install the mod on both server and client
- Start the server once to generate
config/modlistchecker-server.toml - Edit the config file and add your allowed mod IDs
- Restart the server
For detailed installation instructions, visit the GitHub README.
🎮 How it works
When a player connects to a server:
- The client sends its full mod list to the server
- The server checks it against its allowed mod list
- If everything matches → the player joins normally
- 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
ModListChecker Team
