Hytale: Whitelist Setup and Management

Discover how to secure your Hytale game server with whitelist features and control player access → Learn more now

10 November 20262 min read0 Views0 helpful

Introduction

The whitelist is a security and access control feature that lets you specify who is allowed to join your Hytale game server. When enabled, only players explicitly listed on the whitelist can connect. This is especially useful for private servers, community servers, development environments, or testing phases where access should be restricted to trusted players.

Info

Early Access Notice Hytale was released on January 13, 2026, and is currently in Early Access. Since the game is still actively being developed, server software, configuration files, modding support, and installation processes may continue to change.

Enabling the Whitelist

You activate the whitelist directly in-game via the chat – the ZapX console of your Hytale server currently only shows live output and does not support command input. Make sure you have the necessary permissions, such as operator rights, before running the commands.

To enable the whitelist, enter the following command:

Code

/whitelist enable

Once enabled, any player not on the whitelist will be denied access to the server. To check if the whitelist is currently active, use:

Code

/whitelist status

This command shows the current status of the whitelist and confirms that the setting has been applied correctly.

Disabling the Whitelist

If you want to allow all players to join the server again, you can disable the whitelist at any time. Use the following command:

Code

/whitelist disable

After disabling, the server no longer restricts access based on the whitelist, and all players can connect.

Managing the Whitelist

The whitelist can be managed dynamically while the server is running. Players can be added or removed at any time without needing a restart by using the commands.

Adding Players to the Whitelist

To grant a specific player access to the server, add them to the whitelist with this command:

Code

/whitelist add <playername>

The specified player can join immediately, provided the whitelist is enabled.

Removing Players from the Whitelist

To revoke a player's access, remove them from the whitelist:

Code

/whitelist remove <playername>

After removal, the player cannot join as long as the whitelist is active.

Viewing the Whitelist

To see all players currently on the whitelist who are allowed to join, use:

Code

/whitelist list

This command outputs the complete list of whitelisted player names.

Clearing the Whitelist Completely

If you want to remove all players from the whitelist at once, you can clear it completely:

Code

/whitelist clear

This deletes all entries, but the whitelist itself remains enabled.

Managing the Whitelist via File

Besides commands, you can also manage the whitelist directly through a configuration file. This method is useful for bulk changes or preparing the whitelist before the server starts. The file is named whitelist.json and is located in the server directory.

Code

{
  "enabled": true,
  "players": [
    "PlayerName1",
    "PlayerName2"
  ]
}

Conclusion

Congratulations, you have successfully set up the whitelist for your Hytale game server. Your server is now accessible only to approved players, giving you more control, privacy, and a safer multiplayer environment.

If you have any further questions or need assistance, our support team is available daily to help! 🙂

FAQ

Frequently asked questions

Use the in-game chat command /whitelist enable, provided you have the necessary rights (e.g., operator). The ZapX console currently does not support command input.

Use the command /whitelist status to see the current whitelist status.

Use the command /whitelist disable. After that, all players can connect to the server again.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Which 🍪 cookies would you like to allow?

Hytale: Whitelist Setup and Management

Introduction

Enabling the Whitelist

Disabling the Whitelist

Managing the Whitelist

Adding Players to the Whitelist

Removing Players from the Whitelist

Viewing the Whitelist

Clearing the Whitelist Completely

Managing the Whitelist via File

Conclusion

Frequently asked questions

Hytale

Enabling the Whitelist

Disabling the Whitelist

Managing the Whitelist

Adding Players to the Whitelist

Removing Players from the Whitelist

Viewing the Whitelist

Clearing the Whitelist Completely

Managing the Whitelist via File

Conclusion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting