How to Whitelist Players on Your Hytale Server

We continually strive to improve our knowledge base so that our customers have access to the most relevant and up-to-date information. We highly value your suggestions and feedback — if you feel something should be added or corrected, please let us know on our Discord server.

Open a support ticket on our Discord server to let us know how we can improve.

A whitelist restricts your Hytale server to a specific list of approved players. It’s the most reliable way to keep a private server private — only accounts you’ve explicitly added can connect, and a leaked entry just tells you who to remove rather than handing access to anyone who sees it. This guide walks you through enabling the whitelist, adding and removing players, and editing whitelist.json directly when you need to.

Accessing the Server Console

Most of the steps below are run from your server console, but they can also be run in-game if you are already an operator (OP).

NexLink Core customers can log in at panel.nexlinkcore.com, select their Hytale server, and click the Console tab in the left-hand menu. If you host elsewhere, open your provider’s panel and navigate to its console section.

Enabling the Whitelist

The exact command used to toggle the whitelist has shifted between Hytale Early Access builds, so rather than guess, run /help in the game and look for the whitelist command on your version. You’re likely to see one of:

• whitelist on
• whitelist enable

Either form will disable the whitelist with the opposite keyword (off / disable).

Adding a Player to the Whitelist

1. Open the server console.
2. Run whitelist add [username] — replace [username] with the player’s Hytale username.
3. On success, the console will confirm that the player has been added to the whitelist.

Removing a Player from the Whitelist

1. Open the server console.
2. Run whitelist remove [username] — replace [username] with the player’s Hytale username.
3. On success, the console will confirm that the player has been removed.

Listing the Current Whitelist

To see who is currently on the whitelist, run the following command in the server console:

whitelist list

The console will print every username currently approved to join the server.

Editing whitelist.json Directly (Optional)

The whitelist is stored in whitelist.json at the root of your server files, alongside config.json, permissions.json, and bans.json. You can edit it manually, but the console commands above are the recommended approach.

1. Stop your server.
2. Open the File Manager tab in your panel and locate whitelist.json at the root of your server files.
3. Add or remove entries, keeping the JSON valid — every entry must be quoted, separated by commas, and the file must end with a closing bracket.
4. Save the file and start your server again.

Whitelist Command Reference

Below are the available subcommands of the whitelist command.