{"id":20955,"date":"2026-01-13T16:57:23","date_gmt":"2026-01-13T16:57:23","guid":{"rendered":"https:\/\/xgamingserver.com\/blog\/hytale-connection-troubleshooting-fix-upnp-nat-and-cgnat-issues\/"},"modified":"2026-01-13T16:57:23","modified_gmt":"2026-01-13T16:57:23","slug":"hytale-connection-troubleshooting-fix-upnp-nat-and-cgnat-issues","status":"publish","type":"post","link":"https:\/\/xgamingserver.com\/blog\/hytale-connection-troubleshooting-fix-upnp-nat-and-cgnat-issues\/","title":{"rendered":"Hytale Connection Troubleshooting: Fix UPnP, NAT, and CGNAT Issues"},"content":{"rendered":"
\n

Connection Issues?<\/h3>\n

Skip the troubleshooting. Get a managed Hytale server with guaranteed connectivity.<\/p>\n

Get Hytale Server Hosting \u2192<\/a><\/p>\n<\/div>\n

Having trouble connecting to Hytale servers or hosting for friends? This comprehensive troubleshooting guide covers the most common issues and their solutions.<\/p>\n

Share Code Not Generated<\/h2>\n

Symptom:<\/strong> After clicking Save in Online Play settings, no share code appears or you see an error.<\/p>\n

Possible Causes and Fixes<\/h3>\n\n\n\n\n\n\n
Cause<\/th>\nFix<\/th>\n<\/tr>\n
UPnP disabled on router<\/td>\nLog into your router admin panel and enable UPnP<\/td>\n<\/tr>\n
Router doesn’t support UPnP<\/td>\nUse manual port forwarding or Tailscale<\/td>\n<\/tr>\n
Multiple routers (Double NAT)<\/td>\nEnable UPnP on all routers, or connect directly to main router<\/td>\n<\/tr>\n
Firewall blocking UPnP<\/td>\nAllow Hytale through Windows Firewall<\/td>\n<\/tr>\n<\/table>\n

Friend Cannot Connect<\/h2>\n

Symptom:<\/strong> Share code generated successfully, but friend gets connection timeout or failure.<\/p>\n

Possible Causes and Fixes<\/h3>\n\n\n\n\n\n\n\n
Cause<\/th>\nFix<\/th>\n<\/tr>\n
CGNAT (Carrier-Grade NAT)<\/td>\nISP shares one IP among customers. Use Tailscale or dedicated server<\/td>\n<\/tr>\n
Firewall blocking inbound<\/td>\nAllow Hytale through firewall for both private and public networks<\/td>\n<\/tr>\n
UPnP mapping expired<\/td>\nRe-save Online Play settings to refresh the mapping<\/td>\n<\/tr>\n
Antivirus interference<\/td>\nTemporarily disable or add Hytale as exception<\/td>\n<\/tr>\n
ISP blocking game ports<\/td>\nContact ISP or use Tailscale<\/td>\n<\/tr>\n<\/table>\n

How to Check for CGNAT<\/h2>\n

Carrier-Grade NAT means your ISP shares a public IP among multiple customers. UPnP cannot work in this scenario.<\/p>\n

Method 1: Traceroute Test<\/h3>\n
    \n
  1. Open PowerShell (Windows) or Terminal (Linux\/Mac)<\/li>\n
  2. Run: tracert -d 8.8.8.8<\/code> (Windows) or traceroute -n 8.8.8.8<\/code> (Linux\/Mac)<\/li>\n
  3. Check the first few hops<\/li>\n<\/ol>\n

    If the first hop is a public IP<\/strong> (not 192.168.x.x, 10.x.x.x, or 172.16-31.x.x), you likely have a direct connection.<\/p>\n

    If you see multiple private IP ranges<\/strong> before reaching public addresses, you’re behind CGNAT or Double NAT.<\/p>\n

    Method 2: Compare IPs<\/h3>\n
      \n
    1. Check your router’s WAN IP (in router admin panel)<\/li>\n
    2. Check your public IP (search “what is my IP” in browser)<\/li>\n
    3. If they don’t match, you’re behind CGNAT<\/li>\n<\/ol>\n

      Manual Port Forwarding<\/h2>\n

      If UPnP fails but you have a direct public IP, configure manual port forwarding:<\/p>\n

        \n
      1. Note the port shown in your Online Play settings<\/li>\n
      2. Log into your router admin panel<\/li>\n
      3. Find Port Forwarding settings<\/li>\n
      4. Create a rule forwarding the UDP port<\/strong> to your PC’s local IP<\/li>\n
      5. Re-save Online Play settings in Hytale<\/li>\n<\/ol>\n
        \nImportant:<\/strong> Hytale uses QUIC over UDP. Make sure you forward UDP, not TCP.\n<\/div>\n

        IPv6 Connectivity<\/h2>\n

        If both you and your friend have IPv6, the share code includes IPv6 addresses and may connect directly even if UPnP fails.<\/p>\n

        Check IPv6 Status<\/h3>\n

        Visit test-ipv6.com<\/a> to check if you have working IPv6.<\/p>\n

        Dedicated Server Connection Issues<\/h2>\n

        Server Not Found<\/h3>\n