WhitelistGate
by waterflane
WhitelistGate is a server-side access list that checks player nicknames against its own whitelist, separate from the vanilla whitelist.json file.
What it does
Server owners who want a simple access list can use WhitelistGate to admit only chosen nicknames on a Minecraft server, in either online-mode or offline-mode. Nickname matching is case-insensitive. WhitelistGate stores its settings in a separate file, so the vanilla whitelist.json is left alone, and vanilla bans, IP bans, player caps and other join checks continue to apply as they did before. Command changes to the list are saved immediately.
Because the check works on nicknames, it does not verify who owns a name on an offline-mode server, so anyone may join with a nickname belonging to another person. In online-mode the nickname is tied to a verified Minecraft account. Enabling the list kicks players who are already connected and do not match it, and disabling it stops restricting new connections at once. Commands require permission level 3, so they are used by server operators from the dedicated server console.
The mod is built for Forge and NeoForge, is server-side only, and is open source under the Apache License 2.0. Files are published for 1.20.1 and 1.21.1. Players join without installing anything, since vanilla clients connect without the mod, and the mod adds no accounts, passwords, registration database or GUI.
Key features
Separate nickname whitelist
Admits only listed nicknames through its own file, leaving the vanilla whitelist.json untouched.
Immediate command changes
Additions and removals take effect at once and are saved without a server restart.
Live enable and disable
Turning the list on kicks non-listed connected players, and turning it off lets new players in straight away.
Vanilla rules preserved
Existing bans, address bans, occupancy limits and the remaining join checks still take effect while the list is active.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
FerrumWhiteList is a whitelist mod for Forge and NeoForge on 1.20.1 – 1.21.1, with a server required and client optional environment and a custom license that is not open source. authlogic is open source under the MIT License, supports Fabric, Forge and NeoForge for 1.20.1 – 1.21.11, and is run on both client and server. Offline Whitelist is a NeoForge-only mod for 1.21.1, server-side only, under the MIT License and not open source.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| WhitelistGate | Forge and NeoForge | 1.20.1 – 1.21.1 | Server-side only | 2026-07-26 |
| FerrumWhiteList | Forge and NeoForge | 1.20.1 – 1.21.1 | Server required, client optional | 2026-05-29 |
| authlogic | Fabric, Forge and NeoForge | 1.20.1 – 1.21.11 | Client and server | 2026-09-03 |
| Offline Whitelist | NeoForge | 1.21.1 | Server-side only | 2026-07-23 |
Questions
Does WhitelistGate need to be installed on player clients?
Which loaders and versions does WhitelistGate support?
Does the whitelist stop impersonation on offline-mode servers?
In the catalog
WhitelistGate 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.
More from waterflane
Similar mods
What the author says
WhitelistGate is a lightweight, server-side mod that adds an independent nickname-based whitelist without using or modifying Minecraft's vanilla whitelist.json. It is designed for server owners who want a separate, simple access list that works in both online and offline mode. Players do not need to install…
Official listing
- Modrinth page
- modrinth.com/mod/whitelistgate
- Owner
- waterflane
- Published
- 2026-07-26
- Updated on Modrinth
- 2026-07-26
- Facts verified
- 2026-10-15