Hytale Guides

Guide

Hytale Server Not Showing Up: How to Fix Server Discovery

Hytale Server Not Showing Up: How to Fix Server Discovery

The most common reasons a Hytale server fails to appear in the game’s server browser or cannot be directly connected to are incorrect network configuration (specifically failing to forward UDP port 5520), a lack of server authentication, or a client-server version mismatch. Hytale utilizes the QUIC protocol, which relies exclusively on UDP, making proper UDP port forwarding and firewall configuration crucial for server discovery and connectivity.

Encountering issues with server discovery in Hytale can be frustrating, whether you’re a player trying to join a friend’s world or a server owner hoping to see your creation listed. This guide will walk you through systematic troubleshooting steps to diagnose and resolve why a Hytale server isn’t showing up.

Verifying Server Status and Connection Details

1. Confirm Server is Running and Accessible

Before delving into complex network configurations, ensure the server itself is operational.

  • For Server Owners: Check your hosting provider’s control panel or the server’s console. Look for messages indicating that the server has started successfully and is awaiting connections. If the server application isn’t running, it cannot be discovered.
  • For Players: Confirm with the server owner that the server is indeed online and intended to be publicly accessible or available for direct connection.

2. Check IP Address and Port

A simple typo can prevent a connection. Hytale servers default to UDP port 5520.

  • Verify Details: Double-check the IP address and port you are using for direct connection. For example, if the server’s IP is 192.168.1.100, you would attempt to connect to 192.168.1.100:5520.
  • Direct Connect Test: Even if you expect the server to appear in the browser, try a direct connection first. If direct connection works, the issue is likely with the server’s discovery listing, not its basic connectivity.

Network Configuration (Server-Side)

This is often the most critical and overlooked area for self-hosted servers.

3. Port Forwarding for UDP 5520

Your router acts as a gatekeeper for your home network. For external players to connect to your self-hosted server, you must instruct your router to forward incoming traffic on a specific port to the server machine.

  • Access Router Settings: Open a web browser and enter your router’s IP address (often 192.168.1.1 or 192.168.0.1). Log in with your administrator credentials.
  • Locate Port Forwarding Section: This section is typically found under “WAN,” “NAT,” “Virtual Servers,” or “Firewall” settings.
  • Create a New Rule:
    • Protocol: Select UDP. It is crucial to choose UDP, not TCP, as Hytale’s QUIC protocol uses UDP.
    • External/Public Port: Enter 5520.
    • Internal/Private Port: Enter 5520.
    • Internal IP Address: Enter the local IP address of the computer running the Hytale server. This IP address should ideally be static to avoid needing to reconfigure port forwarding if it changes.
    • Enable/Save: Apply and save the new rule.

4. Server Machine Firewall Configuration

Even if your router forwards the port, the server machine’s operating system firewall can still block the connection.

  • Windows Firewall (Windows Defender Firewall):
    • Open “Windows Defender Firewall with Advanced Security.”
    • Go to “Inbound Rules” and create a “New Rule.”
    • Select “Port” and click “Next.”
    • Choose “UDP” and enter 5520 for “Specific local ports.” Click “Next.”
    • Select “Allow the connection” and click “Next.”
    • Choose when the rule applies (e.g., “Domain,” “Private,” “Public”). For a home server, “Private” is usually sufficient, but “Public” might be needed depending on your network setup. Click “Next.”
    • Give the rule a name (e.g., “Hytale Server UDP 5520”) and click “Finish.”
  • Linux Firewalls (ufw, iptables):
    • ufw (Uncomplicated Firewall): Open a terminal and run sudo ufw allow 5520/udp.
    • iptables: This is more complex. A basic rule might be sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT. Remember to save iptables rules after adding them.

Server Authentication and Discovery Listing

5. Authenticate Your Hytale Server

Hytale servers require a one-time authentication with your Hytale account to be listed in the official server browser and to function correctly.

  • Initiate Authentication: In your server’s console, type and execute the command: /auth login device.
  • Follow On-Screen Instructions: The console will display a URL and a unique device code. Open the provided URL in a web browser on any device.
  • Log In: Sign in with the Hytale account you wish to link to the server.
  • Enter Code: Input the device code provided by your server console into the browser.
  • Confirmation: The server console should then display “Authentication successful!” If it doesn’t, retry the process.

6. Check Discovery Listing Status

For servers intended to be publicly listed, ensure the discovery service is receiving heartbeats from your server.

  • Server Heartbeat: After authentication, your server sends periodic “heartbeats” to the Hytale discovery service. Check your server logs for messages indicating successful heartbeat transmissions.
  • Official Guides: Refer to any official Hytale server documentation or guides (if available) regarding the server discovery service for specific status checks or troubleshooting. Ensure your server’s listing status is “Accepted.”

Client-Side Network and Software Issues

Sometimes, the problem isn’t with the server, but with the client’s ability to connect.

7. Client-Side Firewall or Antivirus

Your own computer’s security software can block Hytale from connecting to servers.

  • Windows Defender Firewall: Ensure Hytale and any associated processes (like the Hytale Launcher) are allowed through the firewall for both “Private” and “Public” networks.
  • Third-Party Antivirus/Firewall: If you use software like McAfee, Norton, or Avast, add Hytale as an exception. Temporarily disabling your antivirus/firewall can help diagnose if it’s the culprit, but remember to re-enable it afterward.
  • Smart App Control (Windows 11): If enabled, this feature can sometimes interfere. Consider temporarily disabling it for testing, though re-enabling it might require a Windows reinstall. A safer alternative is to ensure Windows Defender Firewall is configured correctly.

8. Version Mismatch

Hytale is in active development, and client and server versions must often match perfectly.

  • Update Client: Ensure your Hytale client is updated to the latest version via the Hytale Launcher.
  • Update Server: If you are the server owner, ensure your server software is also running the latest version. This often involves restarting the server or following specific update instructions from your host or the official Hytale documentation.

9. Network Adapter Driver Issues (Windows)

Some network card drivers, particularly from Intel and Realtek, can have compatibility issues with modern protocols like QUIC, leading to connection problems.

  • Access Network Adapter Properties:
    • Press Windows Key + R, type ncpa.cpl, and press Enter to open “Network Connections.”
    • Right-click on your active network adapter (e.g., Ethernet or Wi-Fi) and select “Properties.”
    • Click “Configure…” next to your network adapter’s name.
    • Go to the “Advanced” tab.
  • Experiment with Settings: Carefully disable one property at a time, test Hytale, and re-enable it if it doesn’t help. Common culprits include:
    • Priority & VLAN
    • Recv. Segment Coalescing (IPv4/IPv6)
    • Advanced EEE (Energy-Efficient Ethernet)
    • ARP Offload
    • Flow Control
    • Green Ethernet
  • Test with USB Ethernet Adapter: If you have one, connecting via a USB Ethernet dongle can quickly confirm if your built-in network adapter or its drivers are the source of the problem.

10. Network Cache and DNS Issues

Corrupted network caches or DNS problems can prevent your client from resolving server addresses or establishing stable connections.

  • Flush DNS and Reset Network:
    • Open Command Prompt as an administrator.
    • Execute the following commands, pressing Enter after each:
      • ipconfig /release
      • ipconfig /renew
      • ipconfig /flushdns
      • netsh winsock reset
    • Restart your computer after running these commands.
  • Change DNS Servers: Consider temporarily changing your computer’s DNS settings to public DNS servers like Google DNS (8.8.8.8 and 8.8.4.4) or Cloudflare DNS (1.1.1.1 and 1.0.0.1).

11. VPN Use

While often a solution, some users report that using a VPN can resolve connection issues, suggesting underlying incompatibilities with specific ISPs, routers, or router settings.

  • Test with VPN: If you have access to a VPN, try connecting to a Hytale server while the VPN is active. If it works, it points to an issue with your local network or ISP.

Advanced Troubleshooting and Server-Specific Issues

12. Server is Full, Whitelisted, or Password-Protected

Sometimes, the server isn’t showing up because you simply can’t join it, rather than it being undiscoverable.

  • Server Full: If a server reaches its maximum player capacity, you’ll receive a connection error. Server owners can check the max players setting in their config.json.
  • Whitelist/Password: If the server requires a whitelist or password, ensure you are on the whitelist or have the correct password.

13. Corrupted JRE Folder

A damaged Java Runtime Environment (JRE) installation can cause various errors.

  • Delete JRE Folder:
    • Navigate to Hytale’s installation directory. On Windows, this is often in %appdata%\Hytale. On Linux, it might be ~/.local/share/Hytale/.
    • Locate and delete the jre or install folder within the Hytale directory.
    • Relaunch Hytale. The game will automatically download a fresh, uncorrupted JRE.

14. Server Crashes

If the server itself is unstable and crashing, it cannot maintain its discovery listing or accept connections.

  • Check Server Logs: As a server owner, regularly review your server logs for error messages (e.g., NullPointerException, specific crash reports).
  • Recent Updates: Be aware that game updates can sometimes introduce new bugs or incompatibilities that lead to server instability. Consult official Hytale forums or community channels for known issues after patches.

Common Mistakes to Avoid

  • Ignoring UDP: The most frequent error is configuring port forwarding or firewalls for TCP instead of UDP port 5520.
  • Outdated Software: Not keeping both the Hytale client and server updated to the latest version.
  • Overlooking Firewalls: Forgetting to configure both router port forwarding and the software firewall on the server machine.
  • Incorrect Details: Typos in the server’s IP address or port number.
  • Missing Authentication: Failing to perform the one-time server authentication step for official discovery.

By systematically working through these troubleshooting steps, you should be able to identify and resolve why your Hytale server isn’t showing up, allowing players to connect and enjoy the world you’ve created or wish to explore.