Network Configuration
Network Configuration
Hytale uses the QUIC protocol over UDP for all client-server communication. This differs from many games that use TCP.
Default Port
Section titled “Default Port”Port 5520 (UDP)
Change with the --bind argument:
java -jar HytaleServer.jar --assets PathToAssets.zip --bind 0.0.0.0:25565QUIC Protocol
Section titled “QUIC Protocol”Hytale uses QUIC over UDP, not TCP. This is important for:
- Port forwarding configuration
- Firewall rules
- Network troubleshooting
Port Forwarding
Section titled “Port Forwarding”If hosting behind a router, forward UDP port 5520 (or your custom port) to your server machine.
TCP forwarding is not required.
Firewall Rules
Section titled “Firewall Rules”Windows Defender Firewall
Section titled “Windows Defender Firewall”New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action AllowLinux (iptables)
Section titled “Linux (iptables)”sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPTLinux (ufw)
Section titled “Linux (ufw)”sudo ufw allow 5520/udpNAT Considerations
Section titled “NAT Considerations”QUIC handles NAT traversal well in most cases. If players have connection issues:
- Check port forward protocol - Must be UDP, not TCP
- Symmetric NAT - May cause issues; consider using a VPS or dedicated server
- Carrier-grade NAT - Players on mobile networks should connect fine as clients
Building Custom Proxies
Section titled “Building Custom Proxies”If building network infrastructure:
- Use Netty QUIC for proxy development
- Packet definitions are in
com.hypixel.hytale.protocol.packetsin the server jar - Can decode, inspect, modify, or forward traffic
Protocol Versioning
Section titled “Protocol Versioning”Future: SRV Records
Section titled “Future: SRV Records”SRV record support (connecting via domain without port) is not yet available.
The team is evaluating options but hasn’t found a suitable C# library for SRV resolution that meets their stability requirements.