Hytale Guides

Guide

How to Fix Hytale Port Forwarding Issues

How to Fix Hytale Port Forwarding Issues

To host a Hytale server that is accessible to other players over the internet, you must configure port forwarding on your router for UDP port 5520. This creates a direct pathway through your router’s firewall, allowing external connections to reach your specific Hytale server on your local network. This guide will walk you through setting up port forwarding and troubleshooting common issues to ensure your Hytale server is discoverable by friends and other players.

Understanding Hytale Port Forwarding

Your router acts as a security guard for your local network, blocking unsolicited incoming connections from the internet to protect your devices. While this is crucial for security, it also prevents external players from directly connecting to a game server you host on your computer. Port forwarding creates a specific “door” through this firewall, directing traffic on a particular port (in Hytale’s case, UDP 5520) to a designated device (your Hytale server computer) on your local network.

Without proper port forwarding, players attempting to connect to your Hytale server will likely encounter connection errors, as their requests will be blocked by your router before they can reach your server application.

Step-by-Step Guide: How to Configure Hytale Port Forwarding

The exact menu names and locations may vary slightly depending on your router’s manufacturer and model, but the general process remains consistent.

  1. Identify Your Server Computer’s Local IP Address

    Your Hytale server needs a specific address on your local network for the router to direct traffic to. It’s highly recommended to set a static local IP address for your server computer to prevent it from changing.

    • On Windows:
      1. Open the Command Prompt (search for cmd in the Start menu).
      2. Type ipconfig and press Enter.
      3. Look for your active network adapter (e.g., “Ethernet adapter” or “Wireless LAN adapter”).
      4. Note down the IPv4 Address. This is your server’s local IP.
    • On macOS:
      1. Go to System Settings (or System Preferences).
      2. Click on “Network.”
      3. Select your active connection (e.g., Wi-Fi or Ethernet).
      4. Click “Details” (or “Advanced”) and then the “TCP/IP” tab.
      5. Note down the IPv4 Address.
    • On Linux:
      1. Open a terminal.
      2. Type ip a or ifconfig and press Enter.
      3. Look for your active network interface and find the IP address listed next to inet.

  2. Find Your Router’s IP Address (Default Gateway)

    This is the address you’ll use to access your router’s administration page.

    • On Windows: In the Command Prompt output from ipconfig, look for the Default Gateway.
    • On macOS/Linux: Usually found in network settings or by checking route -n in the terminal.
    • Alternatively, it’s often 192.168.1.1, 192.168.0.1, or 10.0.0.1.

  3. Access Your Router’s Administration Page

    Open a web browser (Chrome, Firefox, Edge, etc.) and type your router’s IP address (the Default Gateway you found) into the address bar, then press Enter.

  4. Log In to Your Router

    You’ll be prompted for a username and password. If you haven’t changed them, these are often found on a sticker on your router, in the router’s manual, or are common defaults like admin/admin or admin/password.

  5. Locate Port Forwarding Settings

    Navigate through your router’s interface to find the port forwarding section. Common names for this setting include:

    • Port Forwarding
    • Virtual Server
    • NAT or NAT Forwarding
    • Applications & Gaming
    • Firewall (sometimes nested within this section)

  6. Create a New Port Forwarding Rule for Hytale

    You will need to create a new rule or entry. Fill in the following details:

    • Service Name/Description: Enter a recognizable name, such as Hytale Server.
    • External Port/Start Port/End Port: Enter 5520. Some routers might ask for a range, so enter 5520 for both start and end.
    • Internal Port/Local Port: Also enter 5520.
    • Protocol: This is critical. Select UDP. Do not select TCP unless your router allows “Both” TCP/UDP, but Hytale specifically uses UDP for server connections.
    • Internal IP Address/Device IP: Enter the local IP address of your Hytale server computer that you identified in Step 1.
    • Enable/Save: Ensure the rule is enabled and then click “Apply,” “Save,” or “Add” to store the changes.

  7. Verify Port Forwarding

    After saving the rule, it’s crucial to confirm that the port is indeed open. Use an external online port checker tool (e.g., portchecker.net, canyouseeme.org).

    • Visit one of these websites.
    • The tool will usually detect your public IP address automatically.
    • Enter 5520 as the port to check.
    • The result should indicate that port 5520 is “open” or “successful.” If it shows “closed” or “failed,” proceed to the troubleshooting section.

Troubleshooting Common Hytale Port Forwarding Issues

Ensure a Static Local IP Address for Your Server

If your server computer’s local IP address changes (which can happen if your router assigns IPs dynamically via DHCP), your port forwarding rule will point to the wrong device. To prevent this:

  • Option 1 (Recommended): Configure a static IP address directly on your server computer’s network settings.
  • Option 2: Use your router’s DHCP reservation feature to “reserve” a specific IP address for your server computer’s MAC address.

Configure Your Computer’s Firewall

Even if your router is correctly configured, your computer’s operating system firewall (e.g., Windows Defender Firewall, macOS Firewall) or any third-party antivirus/firewall software can block incoming connections. You must create an exception for the Hytale server application:

  • Allow incoming connections for the Hytale server executable.
  • Specifically allow UDP traffic on port 5520.

Router Reboot

Sometimes, router settings don’t take effect immediately. A simple reboot of your router after saving the port forwarding rule can resolve this.

Check for Double NAT

If you have two routers in your network (e.g., an ISP-provided modem/router and your own Wi-Fi router), you might be experiencing “Double NAT.” This means external connections first hit the ISP router, then your second router. You’ll need to:

  • Port forward on the first router (ISP device) to the second router’s IP address.
  • Then, port forward on the second router to your Hytale server computer’s IP address.
  • Alternatively, configure the second router in “bridge mode” if supported.

Incorrect Protocol (UDP vs. TCP)

A very common mistake is selecting TCP instead of UDP, or not explicitly selecting UDP if your router provides both options. Hytale servers use UDP port 5520.

ISP Restrictions or Carrier-Grade NAT (CGNAT)

Some Internet Service Providers (ISPs) implement restrictions that prevent direct port forwarding, such as blocking common ports or using Carrier-Grade NAT (CGNAT). If you suspect this, contact your ISP. Solutions for CGNAT might include requesting a public IP address (often for an extra fee) or using services like a VPN with port forwarding or a Virtual Private Server (VPS).

Consult Your Router’s Manual

If you’re unsure about specific menu names or options for your particular router model, the manufacturer’s manual (often available online as a PDF) is the best resource.

Important Considerations for Hytale Servers

Hytale is still in development, and while UDP port 5520 is the known default for server connections, future updates or custom server configurations might introduce additional requirements. Always refer to official Hytale server documentation once it becomes available for the most accurate and up-to-date information. Community discussions on platforms like official forums or Reddit can also provide valuable insights and solutions.

Remember that opening ports can introduce minor security risks. Only forward ports that are absolutely necessary for your server to function.