Fix common Hytale server errors

Most Hytale server problems come down to a missing port, a version mismatch, the server’s sign-in, or memory. Start with the quick checks, then find your problem below.

Quick checks

1. Is the server running? Look at the status on Overview. A stopped server doesn’t wake when someone joins. Press Start.
2. Did you type the port? The address must look like orbit.play.wilderack.com:34117.
3. Is everyone on the newest Hytale? Restart the launcher to get updates.
4. What does the Console say? Open Console. If the crash helper card shows a hint, start there.

Problems joining

The game can’t reach the server

You press connect and it times out, or says it can’t connect.

Why: almost always the address or port. Hytale doesn’t support SRV records, so if you leave the port off, the game tries Hytale’s default port 5520. Your server uses the port on your address card instead.

Fix:

1. Copy the address from the address card on Overview with the copy button.
2. In Hytale, edit the saved server and paste the full address, port included.
3. Check the server is Running or Sleeping, not Stopped.
4. If it was asleep, wait a few seconds and connect again. The first try can time out while it wakes.
5. Try another network, like a phone hotspot. Some school, work and public Wi-Fi networks block the traffic Hytale uses (QUIC over UDP).

Joining is slow or the world never loads

You get in, but the world doesn’t load, or you can’t do anything while friends see you move. Single player works fine.

Why: Hypixel says some Intel and Realtek network drivers on Windows have trouble with QUIC, the modern protocol Hytale uses. It affects Wi-Fi and Ethernet.

Fix, on the player’s own PC, trying the game after each step:

1. Open the Start menu, type View network connections and open it.
2. Right-click your internet connection, choose Properties, then Configure.
3. On the Advanced tab, set Priority & VLAN to Priority & VLAN Disabled.
4. If that doesn’t help, set Recv. Segment Coalescing (IPv4) and Recv. Segment Coalescing (IPv6) to Disabled.
5. Still stuck? Hypixel’s support article lists more options to turn off, such as Energy-Efficient Ethernet and Flow Control.

The game and server are on different versions

The join fails right after a Hytale update, or only players who updated can’t join.

Why: the game and the server must use exactly the same protocol version. If they don’t match, the server turns the player away.

Fix:

• Restart the Hytale launcher so it installs the update.
• Your server updates itself by default. If you pinned a version in Settings > Game version, switch back to automatic updates, or players on the new version can’t join.
• If an update came out in the last hour, give the server a few minutes and restart it from Overview.

The server turns you away even though it’s online

You see the server, but it won’t let you in.

Why: the whitelist is on and you aren’t on it, you’re banned, or the server is full.

Fix:

1. In Console, type /whitelist add YourName. Since Update 6, the whitelist works through the hytale.server.join permission, and an old whitelist.json no longer counts.
2. Check bans.json in Files, and use /unban YourName if needed.
3. If the server is full, raise MaxPlayers in Settings or config.json.

Wrong password

If the server has a password, every player has to type it exactly. Check Password in Settings or config.json. Remember it changes only after a restart.

Sign-in problems

Token validation failed. Server starting unauthenticated.

This line appears in the Console when the server starts.

Why: the server’s Hytale sign-in has run out or is invalid. An unsigned server can’t accept players. Sign-ins last as long as the server keeps refreshing them, but run out after 30 days without use.

Fix:

1. In Console, type /auth login device.
2. Open the link shown, sign in to your Hytale account and enter the code.
3. Or restart the server, and Wilderack’s own sign-in takes over.

The sign-in guide explains both options.

The sign-in code expired

The device code from /auth login device lasts 900 seconds, which is 15 minutes. Run the command again for a new code, and enter it at accounts.hytale.com/device straight away.

Your server is missing from Server Discovery

Check each of these:

• Your listing is Accepted in Server Profiles on your Hytale account. New listings wait for a review by hand.
• The server is signed in with the same Hytale account that owns the listing.
• The server is awake. It checks in every two minutes, and a server that goes quiet for longer is hidden. Set it to stay awake under Settings > Sleep.
• The player looking for it doesn’t have a parent-managed account, which can’t use Server Discovery.

Server problems

java.lang.OutOfMemoryError: Java heap space

The server crashes, and the Console shows this line near the end.

Why: the game needs more memory than your plan has. View distance is the usual cause, then mods.

Fix:

1. Set MaxViewRadius to 12 or lower in config.json. The default is 32.
2. Remove mods you don’t use.
3. If it still runs out, move to a bigger plan. The performance guide has a RAM table.

The server stops right after a mod is added

Why: since Update 6, the server shuts down when a core plugin fails to load, instead of running half broken. A mod built for an older Hytale version is the usual cause, because plugins must be rebuilt when the protocol changes.

Fix:

1. Open Console and find the first error. It usually names the mod.
2. Remove it in Mods, or delete its file from mods in Files.
3. Start the server. Install the mod again when its author releases a version for your Hytale version.

Your config changes disappear

Why: Hytale reads its config files when it starts and writes them again when something changes in game. Edits made while it runs are likely to be overwritten.

Fix: stop the server, edit the file, then start it. Or use Settings, which writes the change for you.

The server won’t start after you edit config.json

Why: a typo in the JSON, such as a missing comma, a missing quote or an extra bracket.

Fix: open the file in Files. The editor marks the line with the mistake. If you can’t find it, restore yesterday’s copy of the file from its earlier versions in Files.

An older Hytale version can’t open your world

Why: since Update 7, a world that has been opened on a newer version can’t be read by an older one.

Fix: set Settings > Game version back to automatic updates. If you must go back, restore a backup made before the world was opened on the newer version.

Still stuck?

Write to us at support@wilderack.com, or ask for help from the panel. You can attach your server’s status and recent console lines, so we see what you see. Real people answer.