Server and files

whitelist.json Generator

Build a Java Edition whitelist.json array with player names and UUIDs. Resolve Mojang profiles for online mode or generate official OfflinePlayer UUIDs.

Players

Usernames (one per line or comma-separated)Prefer Mojang online UUIDs (network required and rate-limited)

Enable white-list=true in server.properties, place whitelist.json in the server root, then restart or run /whitelist reload.

Online and offline UUIDs

Online-mode servers must use the UUID assigned by Mojang. Offline-mode servers derive a stable UUID from the exact player name, including capitalization. Choose the mode that matches your server.

Frequently asked questions

Where should whitelist.json be placed?

Place it in the server root beside server.properties and the server JAR.

Can I use offline UUIDs on an online-mode server?

No. Online-mode players use Mojang UUIDs, so offline UUID entries will not match them.

Generated whitelist.json

[
  {
    "name": "Steve",
    "uuid": "5627dd98-e6be-3c21-b8a8-e92344183641"
  },
  {
    "name": "Alex",
    "uuid": "36532b5e-c442-3dbb-a24c-c7e55d0f979a"
  },
  {
    "name": "Notch",
    "uuid": "b50ad385-829d-3141-a216-7e7d7539ba7f"
  }
]