Minecraft whitelist generator
Turn a list of nicknames into whitelist.json and ops.json with the right UUIDs.
About the tool
How to use the file
Put whitelist.json in the server folder, next to server.properties. Turn the whitelist on with white-list=true in server.properties or with /whitelist on, then run /whitelist reload. ops.json goes in the same folder; the server reads it when it starts.
Online or offline mode
A server with online-mode=true checks every player with Mojang, so the file needs each account's real UUID. A server with online-mode=false makes UUIDs from names, so the file needs those instead. Pick the mode your server runs in, or nobody on the list will get in.
Op levels
Level 1 lets an op build in spawn protection. Level 2 adds cheat commands like /gamemode and /tp. Level 3 adds /kick, /ban and /op. Level 4 is every command, /stop included.
FAQ
Where does whitelist.json go?
In the server folder, next to server.properties and the world folder. After you replace it, run /whitelist reload or restart the server.
Why can't a player on the list join?
Most often the mode is wrong: a file made in online mode does not work on an offline-mode server, and the other way round. Also check that the whitelist is on.
Does the case of a name matter?
In online mode, no: the generator writes the name the way Mojang has it. In offline mode, yes: the UUID comes from the name exactly as typed, so type it as the player does.
How many names can I add at once?
Up to 50 in online mode and up to 500 in offline mode. Split a longer list and join the files.
Does this work for Bedrock servers?
No. Bedrock Dedicated Server uses allowlist.json with Xbox IDs, not Java UUIDs. Add Bedrock players with the allowlist add command on the server.