FerrumWhiteList
by MAYDEX
Server owners who want nickname-based access control can use FerrumWhiteList, a server-side whitelist for Forge and NeoForge that checks player nicknames directly.
What it does
Unlike the default Minecraft whitelist, which relies on account UUIDs, FerrumWhiteList compares player nicknames against its list. That makes it suitable for offline-mode servers, where UUID-based checks are less reliable. Because the check is case-sensitive, a name such as MAYDEX22 and a name such as maydex22 count as two separate accounts.
The mod is managed through the ferrum whitelist command, which offers help, on, off, add, remove and list subcommands. Server owners can switch the whitelist on or off, add and remove players, and print the currently whitelisted names. The mod is server required and client optional, so players may install it but are not obliged to.
FerrumWhiteList is published for Forge and NeoForge, with builds for 1.20.1 and 1.21.1. The latest Forge and NeoForge files are both 1.0.0 for 1.21.1. The code is released under a custom license and is not open source.
Key features
Nickname-based checks
Players are matched by nickname instead of account UUID, which fits servers that run in offline mode.
Case-sensitive names
Nicknames are compared exactly, so differently capitalized names count as separate players.
Command-based management
A single ferrum whitelist command with help, on, off, add, remove and list subcommands handles all whitelist work.
Player listing
The list subcommand shows every whitelisted player, so owners can check access without editing files.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Offline-mode servers
Owners running offline-mode servers can rely on nickname matching where the default whitelist is less suitable.
Who it’s for: Server owners and administrators who manage access on Forge or NeoForge servers. Players do not need the mod to join a whitelisted server.
How it compares
WhitelistGate is server-side only, open source under the Apache License 2.0, and available for Forge and NeoForge across 1.20.1 – 1.21.1. Zero Whitelist is server-side only, released under the MIT License, and built only for NeoForge 1.21.1. Limina is also server-side only and uses the Apache License 2.0, but covers 1.19.2 – 1.21.1 on Forge and NeoForge.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| FerrumWhiteList | Forge and NeoForge | 1.20.1 – 1.21.1 | Server required, client optional | 2026-05-29 |
| WhitelistGate | Forge and NeoForge | 1.20.1 – 1.21.1 | Server-side only | 2026-07-26 |
| Zero Whitelist | NeoForge | 1.21.1 | Server-side only | 2025-07-05 |
| Limina | Forge and NeoForge | 1.19.2 – 1.21.1 | Server-side only | 2025-07-07 |
Questions
Does FerrumWhiteList need to be installed on the client?
Which loaders does FerrumWhiteList support?
Why would a server owner choose nickname matching?
In the catalog
FerrumWhiteList is one of 8,016 Management mods on ModsFinder, and one of 2,698 Management mods for Forge. 32,366 mods support Minecraft 1.21.1.
Similar mods
What the author says
FerrumWhiteList is a simple server-side whitelist mod created for Minecraft servers that need nickname-based access control. It was made for servers where the default Minecraft whitelist is not suitable, especially offline-mode servers. Instead of relying only on account UUIDs, FerrumWhiteList checks player nicknames…
Official listing
- Modrinth page
- modrinth.com/mod/ferrumwhitelist
- Owner
- MAYDEX
- Published
- 2026-05-14
- Updated on Modrinth
- 2026-05-29
- Facts verified
- 2026-10-15