Setup a Whitelist on your Hytale server

A whitelist is a list of players that are allowed to join a server. Whether or not a player has a server address or the server password, a player will only be able to join if they are on this list. This guide will show how to set up a whitelist and configure it.

Enable the Whitelist

1. Login to Command Center.
2. From the server list, find the server you wish to modify and click the Manage button on the right.
3. From the server you selected, select the Console tab if you aren't already on the console page.
4. Type /whitelist enable into the console and press Enter.
5. On your computer, start Hytale and try to connect to the server. You should see "Failed to connect to server." If you're still able to join your server, you may need to manually turn on the whitelist:
   1. Click the Files tab above the console
   2. Click on the Server folder, then open whitelist.json
   3. Find the setting "enabled": and change false to true
   4. Save the file and restart the server.

Add players to the Whitelist

On the console page, type /whitelist add playername and press Enter. Replace playername with the actual name of the player you wish to add to the whitelist.

whitelist add MyPlayer123

Removing players from the Whitelist.

On the console page, type /whitelist remove playername and press Enter. Replace playername with the actual name of the player you wish to add to the whitelist.

whitelist remove MyPlayer123

You can also remove every player on a whitelist by typing /whitelist clear into the server console.

View players in the Whitelist

On the console page, type /whitelist list. This will display all players allowed on the server by their UUID.

View Whitelist status

If you don't know if the whitelist is enabled or not, run /whitelist status in the server console. This will show if the whitelist is active or not.

Turn off the Whitelist

If you are done with the whitelist or no longer wish to whitelist a server, it can also be disabled. On the console page, type /whitelist disable to turn off the whitelist.

If non-whitelisted players are still unable to join, open the Files tab, then click on the Server folder and click on whitelist.json to open the whitelist file. Change "enabled": from true to false, then restart the server.