MCUtility

Whitelist Creator

Turn a list of Minecraft: Java Edition usernames into a whitelist.json, with each player’s UUID filled in.

Add players

One per line or separated by commas. UUIDs work too. Up to 100 at a time.

or

The file is read in your browser and never uploaded. Its players are added to the list.

No players yet

Resolved players appear here. Check the list, then copy or download whitelist.json.

Using whitelist.json

  1. Save the file as whitelist.json in the server folder, next to server.properties. If the server is running, run /whitelist reload afterwards.
  2. Make sure white-list=true is set in server.properties (the default for new servers since Java Edition 26.3). With enforce-whitelist=true, players who aren’t on the list are kicked when it is reloaded.
  • Java Edition only. Bedrock Dedicated Server uses allowlist.json with Xbox account details, which this tool doesn’t create.
  • Online mode. The UUIDs here are Mojang account UUIDs, for servers with online-mode=true. Servers with online mode off identify players by an offline UUID calculated from the name, so this file won’t match them. The UUID Lookup shows a player’s offline UUID.
  • UUIDs, not names. The server checks the UUID. If a player changes their name, they stay whitelisted.
  • Operators can always join, even when they aren’t on the whitelist.

Names you enter are sent to this site’s lookup service to find the UUIDs, and the list isn’t saved anywhere. Reloading the page clears it.

Common questions

Does this work for Bedrock servers?

No. Bedrock Dedicated Server uses allowlist.json with Xbox account details, which is a different format.

Do operators need to be on the whitelist?

Not in Java Edition. Operators can always join a whitelisted server, even when they aren’t listed.

Do I need to update the file when a player changes their name?

No. The server matches players by UUID, which doesn’t change when a name does.

Why can’t whitelisted players join my offline-mode server?

With online-mode=false the server identifies players by an offline UUID calculated from their name, which doesn’t match the account UUIDs in this file.