whitelist.json & ops.json Generator

Turn a list of Minecraft player names into properly formatted whitelist.json and ops.json files complete with real UUIDs. This tool supports both online mode lookups and offline mode UUID generation directly in your browser.

Loading the tool…

How the Generator Works

Minecraft Java Edition servers do not rely on usernames alone to track player access and operator permissions. Instead, the server requires properly formatted JSON files containing both the player's name and their Unique User Identifier (UUID).

Paste your list of player names into the tool above to build two essential configuration files:

All entered usernames must follow standard Minecraft account rules: between 1 and 16 characters, using only letters, numbers, or underscores.

Online Mode vs. Offline Mode UUIDs

A player's UUID depends on whether your server authenticates with Minecraft's central account servers or runs in offline mode. Choosing the wrong mode will result in the server rejecting the player or failing to apply operator permissions.

Understanding Operator Levels (1 to 4)

When generating an ops.json file, you must assign a permission level between 1 and 4. These levels control what actions and commands an operator can use on a Java Edition server (such as Vanilla, Paper, Purpur, Spigot, Fabric, or Forge):

  1. Level 1 (Moderator): The player can bypass vanilla spawn protection and edit blocks in the protected spawn area.
  2. Level 2 (Gamemaster): Includes Level 1 permissions, plus access to gameplay and world commands like /gamemode, /tp, /give, and /clear, as well as the ability to use command blocks.
  3. Level 3 (Admin): Includes Level 2 permissions, plus access to multiplayer management commands such as /kick, /ban, /op, and /deop.
  4. Level 4 (Owner): Grants full access to all server commands, including server control commands like /stop and /save-all.

How to Install Your Generated JSON Files

Follow these steps to apply your generated files to a shared Minecraft host, VPS, or dedicated server:

  1. Stop your Minecraft server before uploading new configuration files. If the server is running, it may overwrite your changes when it shuts down.
  2. Open your server's root directory (the same folder that contains eula.txt and server.properties).
  3. Upload or paste the generated contents into whitelist.json and ops.json.
  4. To ensure the whitelist is active, open server.properties and verify that white-list=true is set.
  5. Start your server. If you edit the files while the server is already running, you can run /whitelist reload in the console to apply whitelist changes, though a full restart is needed to reload ops.json.

Questions

Why can't I just type player names into whitelist.json manually?

Modern Minecraft Java Edition servers require a valid UUID alongside every player name in both whitelist.json and ops.json. If the UUID is missing or formatted incorrectly, the server will ignore the entry or fail to read the file.

What does bypassesPlayerLimit do in ops.json?

When bypassesPlayerLimit is set to true for an operator in ops.json, that player can join the server even when the current online player count has reached the maximum limit set in server.properties.

Why did an online mode lookup fail for a username?

In online mode, the tool queries the public PlayerDB API for registered Minecraft Java accounts. If a name is misspelled, contains invalid characters (anything other than 1-16 letters, numbers, or underscores), or does not belong to an existing paid Java Edition account, no online UUID will be found.

How are offline mode UUIDs generated?

When a Minecraft server runs in offline mode, it does not contact external authentication servers. Instead, it creates a version 3 UUID using the MD5 hash of the string "OfflinePlayer:" combined with the case-sensitive player name. This generator performs that exact calculation locally in your browser.

More server tools

See all →