Control Server Access & Restrict Who Can Join
Difficulty
Beginner
Time
5 Minutes
Keep your server private - This guide shows you how to enable a whitelist on your Hytale server, add or remove players, and maintain complete control over who can join.
Quick Navigation
What is a Whitelist?
A whitelist restricts server access to only approved players. When enabled:When to Use a Whitelist
Enable the Whitelist
Whitelisting can be toggled using commands - no server restart required.Via Control Panel Console
Via In-Game (Admin Required)
If you have admin or operator permissions, run the command directly in chat:[!IMPORTANT] Once enabled, only players on the whitelist and admins will be able to join. All other connection attempts will be rejected.
Disable the Whitelist
To make your server public again:Manage Whitelist Players
After enabling the whitelist, you can add or remove players at any time.Add a Player
Remove a Player
Changes apply immediately. Players gain or lose access as soon as the command is executed.
Command Reference
Whitelist File Location
The whitelist is stored in a JSON file on your server:Manual Editing (Advanced)
You can also editwhitelist.json directly via FTP or the file manager:
[!CAUTION] If editing the file manually, stop the server first to prevent conflicts. Restart the server after saving changes.
Troubleshooting
Player Cannot Join Despite Being Whitelisted
Admin Locked Out
Admins and operators can always join, even if not explicitly on the whitelist. If you’re locked out:- Access the server console via control panel
- Run
whitelist offor add yourself withwhitelist add <yourname>
Additional Resources
Need Extra Help?
If you encounter any issues, our support team is ready to assist:- Live Chat: Quick assistance via our website.
- Support Ticket: Open a Ticket
- Discord: Join our Community
- Email: support@freakhosting.com
Last Updated: January 2026 | Need Help? Contact our 24/7 support team!