Adding Users to Whitelist.json in Minecraft Server 1.8

The first rule of Mojang is you never document shit because secretly you hate the people who play your game.

So the other day I installed Minecraft Server 1.8 on a server for my son, and we couldn’t figure out out to add users to the Whitelist, which only allows access to the server to people who are on the list.

The Minecraft server helpfully doesn’t include any examples or a sample file, and most of the crappy Minecraft sites out there are happy to list the various options, but again no sample files or detailed explanations of how the Whitelist.json needs to be properly formatted.

Anyway, this is the format the Whitelist.json needs:

[
  {
    "uuid": "xxxxx-xxx-xxxxx-xxxx",
    "name": "username"
  }
]

To get the UUID, there are a number of websites (like this one) that will let you enter a username and will kick back the UUID.

8 thoughts on “Adding Users to Whitelist.json in Minecraft Server 1.8”

  1. Here’s another way.

    Log into the server and issue this command:

    /whitelist on
    /whitelist add username

    You can look at the whitelist.json file and see the uuid is automatically populated.

  2. @tim:

    In your console type “whitelist add yourusername” to add you to your servers whitelist. Hope this helps anybody reading this later on!

  3. Comment on that:
    To add more than one user, make sure you have a comma after the last curlybracket:
    [
    {
    “uuid”: “xxxxx-xxx-xxxxx-xxxx”,
    “name”: “username”
    },
    {
    “uuid”: “xxxxx-xxx-xxxxx-xxxx”,
    “name”: “username”
    },
    {
    “uuid”: “xxxxx-xxx-xxxxx-xxxx”,
    “name”: “username”
    }
    ]
    Otherwise, you will recieve a bad formatted array error and the whitelist will not function properly:
    [22:19:24] [Server thread/WARN]: Failed to load white-list:
    com.google.gson.JsonSyntaxException: com.google.gson.stream.MalformedJsonException: Unterminated array at line 6 column 4

  4. Bonjour, j’ai mis une liste blanche pour mon serveur mais je ne sais pas l’utiliser. On peut m’aider S.V.P

Leave a Reply