Quick answer
- Sign the server in once with
/auth login device. - Make yourself operator with
/op add <player>from the Console. - Control access with
/whitelist add,/banand/kick; type/helpfor the full list on your build.
Hytale is in Early Access and commands can change between builds. The /help output on your server is always the reference.
Signing the server in#
/auth login device
/auth status/auth login device prints a link and a short code; approve it at accounts.hytale.com/device with your Hytale account. /auth status shows whether the server is signed in and when its token expires. If players get authentication errors, check this first.
Operators#
/op add YourName
/op remove YourNameRun these in the panel's Console, which already has full rights. On FreeGameHost the Allow operators setting on the Startup page must be on for op to work.
Whitelist#
/whitelist add FriendName
/whitelist remove FriendName
/whitelist list
/whitelist enable
/whitelist disableKick and ban#
/kick PlayerName
/ban PlayerName Griefing spawn
/unban PlayerNameBans are saved by the server, so they survive restarts.
Finding every command#
Type /help to list the commands your build supports, and /help <command> for details. Server mods and plugins add their own commands, so the list grows as you install them; see the best Hytale server mods.
Still setting up? Start with how to make a Hytale server, or check Hytale server not working: fixes.
Run /auth status any time to see whether the server is signed in and when its token expires. If players get an authentication error, this is the first thing to check.
Self-hosting is free, but your PC has to stay on for anyone to play, and your home upload speed limits how many players it can handle.
Option 2: a free hosted Hytale server#
On FreeGameHost the server files, Java 25 and the network are set up for you. Free Hytale servers get 6 GB RAM, 200% CPU and 10 GB of NVMe storage and run in our North America location.

- Create the server
Sign up at panel.freegamehost.xyz (no credit card), click Create Free Server, choose Hytale, the United States location and a name.
- Start it and approve the download
Press Start. On the first start the official downloader fetches the server files. If the console shows a sign-in link and code, open it and approve it with your Hytale account.
- Sign the server in
When the server has booted, type
/auth login devicein the console, approve the code ataccounts.hytale.com/device, then run/auth persistence Encrypted. - Share the address
Copy the server address from the top of the Console page and send it to your friends.
How players join#
In Hytale, open the Servers screen, add a server and enter the address. If the server doesn't use the default port, include it after a colon, for example us.freegamehost.xyz:24105. Players don't need to install anything extra, even on a modded server.
Adding mods and plugins#
Hytale mods run on the server. Put mod files into the server's mods folder (with the file manager or SFTP) and restart. Players receive the content automatically when they join.
- Download mods from trusted sources such as CurseForge and check they match your server's Hytale version.
- Some plugins load before the main server starts. Hytale asks you to accept those explicitly: on FreeGameHost, turn on Accept Early Plugins in the Startup settings.
- Add mods one at a time. If the server won't start, the last mod you added is the first suspect.
Looking for ideas? See our list of the best Hytale server mods.
How much RAM does a Hytale server need?#
RAM use grows mainly with view distance and the number of players spread out across the world. As a rough guide:
| Server | Suggested RAM |
|---|---|
| 2 to 5 friends, default settings | 4 GB |
| 5 to 15 players, a few mods | 6 to 8 GB |
| Larger communities or heavy mods | 8 GB or more, with a lower view distance |
If the server struggles, lower the maximum view radius in config.json before adding more RAM. It's the setting with the biggest effect. For bigger communities, our premium Hytale plans go up to 32 GB.
Troubleshooting#
Players can't connect#
Check that the port is open for UDP (a TCP-only rule is the most common mistake), and that players use the right port. Run /auth status to make sure the server is still signed in.
"Server session token not available"#
The server isn't signed in, or its login expired after a restart. Run /auth login device again, then /auth persistence Encrypted.
The server won't start#
Check the Java version first (java -version must show 25). If you've just added a mod, remove it and try again. On a hosted server, the console log shows the exact error.
See also: How to make a Factorio server
Frequently asked questions#
How do I make myself admin on a Hytale server?
Run /op add YourName in the server console. On FreeGameHost, turn on Allow operators on the Startup page first.
Why do players get an authentication error?
The server isn't signed in or its token expired. Run /auth status, then /auth login device if needed.
How do I see all Hytale commands?
Type /help on your server. Commands can change between Early Access builds, so your server's list is the reference.
