Whitelist Creator — Generate whitelist.json for Your Hytale Server on AlaHytale
By AlaHytale — June 8, 2026
The AlaHytale Whitelist Creator is a free browser tool that generates a ready-to-use whitelist.json file for a Hytale server. With the Whitelist Creator you type a player's Hytale username, the tool resolves that username to its UUID through the PlayerDB database, and it builds the JSON your server needs to control who is allowed to join. No account, no registration, and nothing you enter ever leaves your browser.
This article explains what the Whitelist Creator does, who it is for, the exact file it produces, and how to use it step by step. The Whitelist Creator lives at alahytale.com/tools/whitelist-creator and works in all six site languages.
Built for: Server owners Admins Communities Modpack hosts
What the Hytale Whitelist Creator Does
A whitelist is an access list: when a server runs in whitelist mode, only the players on that list can connect. The Whitelist Creator turns a plain list of Hytale usernames into the structured whitelist.json file a server reads, so a server owner never has to look up UUIDs or hand-edit JSON. Each name you add is verified against PlayerDB, and the Whitelist Creator shows the player's 2D avatar and UUID next to their name so you can confirm you added the right person before you ship the file.
The Whitelist Creator is built for Hytale server owners and administrators. As of June 2026, Hytale is in early access (the game entered early access on January 13, 2026, per Hypixel Studios), and many players run private or community servers where controlling who can join matters. The Whitelist Creator removes the most tedious part of that job — converting human-readable names into the machine-readable UUID format a whitelist file expects.
The whitelist.json File the Tool Produces
The Whitelist Creator outputs a small, clean JSON object with two fields: an enabled flag and a list of player UUIDs. A live preview updates in real time as you add or remove players, so the file you download always matches exactly what is on screen. The structure looks like this:
{
"enabled": true,
"list": [
"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
]
}
The enabled field reflects the "Whitelist Enabled" toggle in the tool. When it is on, only players whose UUIDs appear in list are meant to join; when it is off, the server is open to everyone. You can download the file with one click, or copy the JSON straight from the preview into your own editor.
Key Features of the Whitelist Creator
enabled flag in the output between a closed (whitelist-only) and an open public server.whitelist.json as you build it and copy it to your clipboard in one click.whitelist.json file ready to drop onto a server, or use Clear All to start over.
Privacy: The Whitelist Creator stores your player list only in your browser via localStorage. The list persists between visits and is never uploaded to AlaHytale. If you clear your browser data, the list is cleared too.
How to Use the Hytale Whitelist Creator
Building a whitelist with the Whitelist Creator takes four steps.
whitelist.json preview update as you build the list. Confirm each avatar and UUID matches the player you intended.whitelist.json containing every player UUID, or copy the JSON directly from the preview into your own editor.whitelist.json file in your Hytale server's configuration directory and reload the server. Hytale's official server tooling is still evolving during early access, so check your host's documentation for the current reload step.Hytale Whitelist Creator — Frequently Asked Questions
Is the Whitelist Creator free?
Yes. The Whitelist Creator on AlaHytale is completely free, with no account or registration required. You can build, download, and copy as many whitelist files as you want.
How do I find a player's UUID?
You don't have to. You enter the player's Hytale username and the Whitelist Creator resolves the UUID for you through the PlayerDB database, then adds it to the list automatically.
What does "Whitelist Enabled" do?
"Whitelist Enabled" sets the enabled field in the output file. When it is on, only players whose UUIDs are in the list are meant to join your server. When it is off, the server is open to everyone (public mode).
Can I edit the JSON by hand?
Yes. You can copy the JSON from the live preview, edit it in any text editor, and paste it into your server configuration. The Whitelist Creator just gives you a correct starting point.
Is my player list saved?
Your list is saved locally in your browser via localStorage, so it is still there next time you open the Whitelist Creator. It is never sent to AlaHytale servers — everything happens on your device.
What if a player username isn't found?
The Whitelist Creator shows an error if a username cannot be found in PlayerDB. Check the spelling and try again — usernames are matched case-insensitively.
whitelist.json in under a minute. While you are here, try the Username Checker to validate names and the Server Checker to see your server's live status.