Wiki 9Minecraft Wiki 9Minecraft
Easy Whitelist Wiki › Guides › How to Manually Format Server JSON Lists

How to Manually Format Server JSON Lists

Structural Rules for JSON Files

When managing lists outside the game, you may need to edit whitelist.json, ops.json, or banned-players.json directly. Even though Easy Whitelist allows in-game commands to process usernames without requiring real UUID lookups, the server's underlying JSON files still require both fields for every entry.

Each list entry must contain:

1. A name key with the player's exact case-sensitive username.

2. A uuid key with a correctly formatted UUID string.

Adding Valid Entries

The UUID does not need to be the player's genuine Mojang UUID—it can be random—but it must follow the standard 8-4-4-4-12 hexadecimal character structure.

Example entry format:

`json

{

"uuid": "01234567-89ab-def0-1234-56789abcdef0",

"name": "NikitaCartes"

}

`

When writing entries manually:

  • Always ensure hyphens divide the hexadecimal digits into groups of 8, 4, 4, 4, and 12 characters.
  • Check that the name value exactly matches the target account's casing.
  • Enclose all objects within the main JSON array ([...]) and separate multiple entries with commas.