Hytale connection problems

Hytale: fixing "failed to connect to server"

Three causes explain almost every Hytale connection error: a version mismatch after an update, a closed UDP port, or NAT when hosting from the game.

First check whether server and client run the same Hytale version. They must have the exact same protocol version, and after an update a mismatch is one of the most common causes of "failed to connect" and "connection closed".

Versions match? Then look at the port: Hytale uses UDP 5520, not TCP. And if you host from the game itself, the network configuration warning is almost always about NAT: your router does not let incoming connections through.

What do "failed to connect" and the other Hytale messages mean?

Of the four messages people search for most, three mean something other than they seem.

"Failed to connect to server"

The client cannot reach the server. Usually: a wrong address or port, a server still starting up, or UDP 5520 closed in a firewall or router. Did the server or your client just get an update? Then it is often a version mismatch.

Copy address and port exactly from the panel, wait until the console says the server has started, check UDP 5520.

"Connection closed"

The connection was made and then dropped. That is a version or protocol mismatch, a server that is not (or no longer) authenticated, a full server (MaxPlayers), a whitelist or a kick.

Put client and server on the same version, check MaxPlayers and the console, authenticate again if needed.

"Your network configuration may prevent other players from connecting"

You see this as host when you host from the game and automatic port forwarding fails. Since Update 6 Hytale then tries STUN and TURN. Double NAT, for example behind a second router or your provider's CGNAT, did not work yet according to the Update 6 patch notes; the Update 7 notes do not mention a fix.

Turn on UPnP or forward UDP 5520 (the default port) on your router, keep one router in the chain, or get a server on a public IP address.

Server not authenticated

A Hytale server has to be linked to a Hytale account. Without valid authentication players cannot log in.

In the server console: /auth login device, then /auth persistence Encrypted so the server does not ask again after a restart.

How do you get a working connection in six steps?

Top to bottom. Most servers are done by step two.

  1. Matching versions

    Compare the version number in the game with the one in the server console. Client and server must run the exact same protocol version. After a Hytale update, update the server first and restart it.

  2. Address and port

    Address and port come straight from the panel. A free subdomain prevents typos. Add the port after a colon, because Hytale does not support SRV records yet.

  3. UDP 5520 open

    On a hosted server the port is open at delivery. At home: forward it on the router as UDP, not TCP, and check the PC's firewall.

  4. Server ready

    The server loads its assets first. Connecting before the console says it has started gives a failed to connect that goes away by itself.

  5. Authentication and limits

    Check whether the server is authenticated (/auth), whether MaxPlayers has been reached and whether a password or whitelist is stopping the player.

  6. Read the logs

    The console almost always says why a player was refused. Search for the player's name or the time of the attempt. Hosting from the game? The Copy Network Report button from Update 7 creates a diagnostic without addresses in it, which you can share safely.

Why does a hosted server not have this problem?

When you host from the game, your PC sits behind a router, sometimes behind two. A hosted server sits on a public IP address with the port open: there is no NAT to get through.

  • Public IPv4 address and UDP 5520 open at delivery
  • The server keeps running when you turn your PC off
  • Free subdomain, so players do not have to remember an IP address
  • Update the version and restart from the panel
  • DDoS protection on our network

Choose your package

Delivered right after payment, with the port open and Java 25 ready.

Zombie

Minimum memory for Hytale

  • 4096 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€5.95p/m

Cancel monthly

Order

Cattle

  • 6144 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€8.95p/m

Cancel monthly

Order

Deer

  • 8192 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€11.95p/m

Cancel monthly

Order

Warthog

  • 10240 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€14.95p/m

Cancel monthly

Order

Which size? See the RAM guideline per player count. Server lagging once everyone is in? Then it is time for the best settings.

Sources

The official Hypixel Studios documentation and patch notes this page is based on.

Frequently asked questions

Why do I get "failed to connect to server" after a Hytale update?
Because server and client are not on the same version. They must have the exact same protocol version, and it changes with updates: Update 6 moved from hytale/2 to hytale/3 and Update 7 raised the version again. Update the server, restart and try again.
Which port do I need to open for Hytale?
UDP 5520. Hytale uses QUIC, and that runs over UDP. A TCP rule for 5520 does nothing.
What does "your network configuration may prevent other players from connecting" mean?
That you host from the game and automatic port forwarding fails, so players outside your home network may not get in. Since Update 6 the game helps with STUN and TURN, and Update 7 fixed a bug where automatic port forwarding could not find the router. Still not working? Turn on UPnP or forward UDP 5520; otherwise a server on a public IP address is the fix.
My friends see "connection closed". What is wrong?
The connection was made and then dropped. Check the version, MaxPlayers, any password or whitelist, and whether the server is still authenticated. The console shows which one it was.
How do I authenticate my Hytale server?
In the server console: /auth login device and follow the link. Then /auth persistence Encrypted, so the server does not ask for authentication again after a restart.
Does Hytale work behind CGNAT or double NAT?
Playing on someone else's server works: according to the manual, players behind CGNAT can connect normally. Hosting from the game behind double NAT did not work yet according to the Update 6 patch notes, and the Update 7 notes do not mention a fix. The manual also says symmetric NAT can cause problems. A hosted server on a public IP address avoids the issue entirely.