Mod Whitelist
Mod Whitelist is a security mod for Fabric and Forge that stops players whose installed mods conflict with a server's modlist from joining.
What it does
The server keeps a list of mod identifiers, and the client sends the identifiers of its installed mods to the server in encrypted form. The server compares that list with its own rules and refuses the connection when a player has a blocked mod or lacks a required one. Both sides run the mod, and each side works separately, so the client and the server each need it installed.
Server owners use the mod to keep out players who install hacking mods, and to avoid join problems caused by mismatched mod sets. Mod Whitelist is published for 1.20 – 1.20.4, with the latest Fabric and Forge files at 1.2.0 for 1.20.4, released under the MIT License and open source. It is a server and client mod that requires both sides to be installed.
Rules are set in the config file. Required and blocked mods are listed by their modids, and a whitelist-only mode can be turned on so that only the listed modids are allowed. Logs on the client show the modids of installed mods, which makes it easier to collect the identifiers to enter.
Key features
Modlist matching
The server checks the mods a joining player has installed against its rules and refuses players who do not match.
Encrypted modid exchange
The client sends its installed mod identifiers to the server in encrypted form before the connection is accepted.
Blacklist and whitelist modes
Servers can block specific mods by default, or switch to a mode where only listed modids are permitted.
Required client mods
A field in the config lists mods the client must install, so players without them cannot enter.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Server owners who want to control which client mods can join, and players who need to know which mod identifiers a server expects.
How it compares
LAN Whitelist is a Fabric-only mod for 1.20.2 – 1.21.10 that runs on client and server and is open source under the MIT License. Better ModList is open source under the MIT License, published for Forge and NeoForge on 1.20 – 26.3, and runs on the client alone. Modlist Snooper is a Forge mod for 1.20.1 with client and server environment and is not open source. Mod Whitelist is open source under the MIT License and works on Fabric and Forge across 1.20 – 1.20.4.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Mod Whitelist | Fabric and Forge | 1.20 – 1.20.4 | Client or server, optional | 2024-03-26 |
| LAN Whitelist | Fabric | 1.20.2 – 1.21.10 | Client and server | 2025-10-18 |
| Better ModList | Forge and NeoForge | 1.20 – 26.3 | Client-side only | 2026-10-05 |
| Modlist Snooper | Forge | 1.20.1 | Client and server | 2024-03-06 |
Questions
Does Mod Whitelist have to be installed on both sides?
How does a server owner find a mod identifier?
Which loaders does Mod Whitelist support?
In the catalog
Mod Whitelist is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,907 mods support Minecraft 1.20.4.
More from Viola-Siemens
Similar mods
What the author says
Thank you for choosing our Mod Whitelist mod to protect your server from client hacking mods. Let me introduce how it works and what you can do. The config file is in "<server directory>/config/mod_whitelist-config.json". If you want to add mods to the whitelist or blacklist, please read the following guides.
Official listing
- Modrinth page
- modrinth.com/mod/mod-whitelist
- Owner
- Viola-Siemens
- Published
- 2023-12-11
- Updated on Modrinth
- 2024-03-26
- Facts verified
- 2026-10-15