hytale
tools
server
whitelist creator

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.

Hytale Whitelist Creator — server management tool on AlaHytale
The AlaHytale Whitelist Creator builds a server-ready whitelist.json from plain usernames.
UUIDResolves every username to its Hytale UUID
BulkImport many usernames at once
100%Local — data stays in your browser
FreeNo account, no registration

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

Username lookup with avatarsEvery name is checked against PlayerDB; the Whitelist Creator shows the player's UUID and 2D avatar so you confirm the right account.
Bulk ImportPaste a list of usernames (one per line) and the Whitelist Creator adds them all at once, skipping duplicates automatically.
Whitelist Enabled toggleSwitch the enabled flag in the output between a closed (whitelist-only) and an open public server.
Live JSON preview + CopySee the exact whitelist.json as you build it and copy it to your clipboard in one click.
One-click DownloadSave a finished whitelist.json file ready to drop onto a server, or use Clear All to start over.
Private & localYour list is saved in your browser's localStorage and is never sent to AlaHytale servers.
Hytale whitelist generator interface — add players, toggle and download whitelist.json
Add players, flip the Whitelist Enabled toggle, and download the generated whitelist.json.

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.

1
Add your players. Type each Hytale player's username and press Enter. The Whitelist Creator looks the name up in PlayerDB, adds the player's UUID, and shows their avatar. Use Bulk Import to add a whole list of usernames at once.
2
Toggle and verify. Keep "Whitelist Enabled" on so only listed players can join, and watch the live whitelist.json preview update as you build the list. Confirm each avatar and UUID matches the player you intended.
3
Download whitelist.json. Click Download to save the generated whitelist.json containing every player UUID, or copy the JSON directly from the preview into your own editor.
4
Install it on your server. Place the 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.

Ready to lock down your server? Open the Whitelist Creator and build your first 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.