Hytale Connection Diagnostic
Can't connect to a Hytale server? Follow this step-by-step troubleshooting guide to identify and fix the issue.
Important: Hytale uses UDP port 5520 by default. Most connection issues are caused by incorrect port forwarding or firewall settings.
Live Diagnostics
Your Public IP
This is the IP players use to connect to your server
Server Address to Test
UDP Port Check (External Tool Required)
Browsers cannot directly check UDP ports. Use an external port checker to verify UDP 5520 is open.
Open Port Checker (Enter IP: your IP, Port: 5520, Protocol: UDP)Step 1: Check Port Forwarding
Hytale uses UDP port 5520 by default. This port must be forwarded on your router.
Check these items:
- •Is UDP port 5520 forwarded to your server's local IP?
- •Did you set the correct internal IP (not 127.0.0.1)?
- •Is the port range set correctly (5520-5520)?
Step 2: Check Firewall Settings
Windows/Linux firewall may block incoming connections even with port forwarding.
Step 3: Verify Server is Running
The server process must be running and listening on the correct port.
Step 4: Verify Connection IP
Players must connect using your public IP, not your local IP.
Step 5: Check Mod Compatibility
Mismatched or conflicting mods can prevent connections.
Diagnostic Report
Share this report with server administrators if you need help troubleshooting.
Connection FAQ
Why UDP and not TCP?
Hytale uses UDP for game traffic because it's faster for real-time gameplay. UDP 5520 must be forwarded, not TCP.
Can I change the default port?
Yes, edit server-port in your server config. Players will need to connect with your IP:port format.
I'm on the same network as the server
Use the server's local IP (192.168.x.x) instead of the public IP. Port forwarding isn't needed for LAN play.