Offline Whitelist
by rymusov
Offline Whitelist restricts an offline-mode NeoForge server to a set of approved player usernames, and disconnects everyone else during the connection phase.
What it does
Servers running with online-mode=false accept any username without checking an account, so the server has no way to tell who is connecting. Offline Whitelist fills that gap by validating each connecting player against a list of nicknames. Connections from names that are not on the list are cut off early, before the player reaches spawn, so unapproved players never enter the world and leave little trace in server chat.
The mod is server-side only: clients need nothing extra and work with vanilla installs. Its commands require Operator permission, and the shorter alias owh works in place of offwhitelist. The approved list is stored in plain JSON files in an organized config directory that can be edited by hand. The mod is published for NeoForge 1.21.1 only, under the MIT License, and is not open source.
Key features
Username-based access
Only players whose nicknames appear on the list can join the server, with no account check involved.
Early connection blocking
Players not on the list are disconnected during the connection phase, before they spawn in the world.
Offline-mode focus
The mod is built for servers that run with online-mode=false, where usernames are the only identity available.
Editable JSON lists
The approved players are kept in simple JSON files inside a tidy config directory, which can be changed by hand.
Operator commands
Management commands run with Operator permission, and can be called as offwhitelist or the shorter owh.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Cracked community servers
An operator running a closed group on an offline-mode server can limit entry to the usernames of its members.
Who it’s for: Server owners who run offline-mode servers and want a username list controlling who may join. Players need no installation, since the mod only runs on the server.
How it compares
Zero Whitelist is also server-side only and MIT licensed, but it is published for 1.21.1 and is not open source. WhitelistGate is open source under the Apache License 2.0 and covers Forge and NeoForge for 1.20.1 – 1.21.1, so it fits servers on Forge too. Basic Login is server-side only and MIT licensed for 1.21 – 1.21.4, and is a different kind of login system rather than a whitelist.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Offline Whitelist | NeoForge | 1.21.1 | Server-side only | 2026-07-23 |
| Zero Whitelist | NeoForge | 1.21.1 | Server-side only | 2025-07-05 |
| WhitelistGate | Forge and NeoForge | 1.20.1 – 1.21.1 | Server-side only | 2026-07-26 |
| Basic Login | NeoForge | 1.21 – 1.21.4 | Server-side only | 2025-01-15 |
Questions
Does Offline Whitelist need to be installed on clients?
Which loader and game version does Offline Whitelist support?
Can the approved list be changed without a command?
In the catalog
Offline Whitelist is one of 8,016 Management mods on ModsFinder, and one of 2,689 Management mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from rymusov
Similar mods
What the author says
Offline Whitelist is a server-side mod designed specifically for servers running with online-mode=false. It validates players by nickname, ensuring that only approved users can access your server. Because it operates entirely server-side, it requires no client installation and works seamlessly with vanilla clients…
Official listing
- Modrinth page
- modrinth.com/mod/offlinewhitelist
- Owner
- rymusov
- Published
- 2026-07-22
- Updated on Modrinth
- 2026-07-23
- Facts verified
- 2026-10-15