Offline Whitelist - Username-Based
Running a Minecraft server in offline mode opens the door to friends, community members, and newcomers who do not own a premium account. The tradeoff is that vanilla whitelisting stops working the way you expect, because it relies on UUIDs that offline players simply do not have. That is exactly the gap Offline Whitelist - Username-Based fills. This lightweight, server-side utility lets you build a reliable whitelist keyed purely on usernames, so you decide who gets through the gate.
Why Offline Mode Needs a Different Whitelist
In online mode, Mojang's authentication servers verify every player and assign a unique UUID. In offline mode, no such verification happens, and the vanilla whitelist system becomes unreliable or unusable for your purposes. Offline Whitelist - Username-Based for Minecraft sidesteps the problem entirely by ignoring UUIDs and matching players against a plain username list. If a name is on your list, the player joins. If it is not, they are turned away. It is that straightforward.
This makes the add-on ideal for private survival worlds, modded communities, testing environments, and any server where account verification is not part of the plan but controlled access still matters.
Key Features at a Glance
- Server-side only utility: install it on the server and leave clients untouched.
- Username-based matching that ignores UUIDs completely.
- Simple chat and console commands for adding, removing, and listing players.
- No configuration files to wrestle with, no dependencies to chase down.
- Designed for offline-mode servers where the vanilla whitelist falls short.
Supported Versions and Loaders
The mod is built for modern Minecraft releases and ships as a Fabric mod, so it slots neatly into Fabric-based servers running contemporary game versions. Because it is purely server-side, players connecting from vanilla clients or other mod loaders are unaffected. If you are planning a download Offline Whitelist - Username-Based, check the file listing to confirm the build matches your server's Minecraft version before you deploy it.
How to Install Offline Whitelist - Username-Based
Installation is refreshingly simple, and knowing how to install it takes only a minute. Follow these steps:
- Stop your server before making changes.
- Place the mod file into your server's mods folder. You do not need to install anything on the client side.
- Disable the vanilla whitelist, since this add-on replaces its role.
- Start the server and confirm the mod loads without errors.
- To admit the first player, run the whitelist add command from the server console.
Once the server is live, managing access is handled through three commands. Use /whitelistusernameadd username to grant entry, /whitelistusernameremove username to revoke it, and /whitelistusernamelist to review everyone currently approved. Keeping that list tidy is the whole job.
Managing Your Player List Day to Day
Adding and Removing Players
Because matching is done by name alone, accuracy matters. Double-check spelling when you add someone, since a typo means a legitimate player stays locked out. Removing a player is just as quick, which is handy when a community member leaves or a name needs to be recycled.
Reviewing Access
The list command gives you an instant snapshot of who is approved, making audits painless. Pair it with regular backups and you have a clean, transparent access policy that anyone on your admin team can follow.
If you prefer a smoother setup flow, the foxygame.net launcher bundles Offline Whitelist - Username-Based in its add-on catalog, letting you add it to a server profile with a single click instead of hunting for the right file manually.
Final Thoughts
Offline Whitelist - Username-Based solves a narrow but genuinely annoying problem with elegance. It does one job, does it well, and stays out of your way. For admins running offline-mode servers who still want a firm grip on who joins, this small utility earns its place in the mods folder. Grab the right build for your Minecraft version, drop it in, disable the vanilla whitelist, and start approving players by name.