Skip to main content

How to Fix Unity Multiplayer Connection Timeouts on Mobile Data

Updated

Players attempting to connect to a Unity multiplayer game may experience immediate disconnects or a timeout error. This issue typically occurs exclusively on mobile data (cellular) networks. The game often works perfectly when connected to Wi-Fi or when tethered to a mobile hotspot, but consistently fails on a direct mobile network connection.

Why is this happening?

When a multiplayer connection fails specifically on mobile data, it may be caused by local device settings or cellular carrier restrictions blocking the persistent connections (WebSockets) required for real-time gameplay. The most common culprits are:

  • Ad Blockers and Custom DNS: Many privacy apps, local VPNs, or custom DNS providers use broad filter lists to block ads and analytics. Because Unity operates analytics platforms, these filters frequently block all *.unity3d.com domains by default. This accidentally blocks the critical multiplayer servers required to keep you connected to the game.
  • Cellular Carrier Restrictions: Some mobile data providers have strict firewalls or aggressive data-saving protocols that silently drop persistent background connections. While standard web browsing works fine, the long-lived connection required for multiplayer gaming is blocked by the carrier.

Workarounds & Solutions

If you are unable to connect to a multiplayer game on your mobile device, try the following steps:

  1. Switch to Wi-Fi: The quickest way to bypass cellular network restrictions and mobile data-saving protocols is to connect to a stable Wi-Fi network.
  2. Disable Ad Blockers or Custom DNS: If you are using a network-wide ad blocker, a local VPN, or a Private DNS, temporarily disable it to see if the game connects.
  3. Whitelist Unity Domains: If you want to keep your ad blocker active, you will need to manually allowlist the specific servers the game needs to function. Add the following domains to your allowlist/whitelist:
    • wire.unity3d.com
    • *.services.api.unity.com (If your blocker does not support wildcards, you may need to whitelist the specific unity service subdomains the game uses, or temporarily pause the blocker).

UX Considerations

If you are receiving reports of this issue from your player base, you cannot change their mobile carrier or force them to uninstall their ad blockers. However, you can make your game more resilient:

  1. Graceful UI Prompts: Detect consecutive connection timeouts. If the connection repeatedly fails on a mobile device, display a helpful UI message (e.g., "Connection failed. If you are using an ad blocker, custom DNS, or strict mobile data network, it may be restricting multiplayer functionality. Please connect to Wi-Fi.").
  2. Implement an HTTP Fallback: Because mobile networks and proxies frequently drop persistent WebSockets, consider building a fallback mechanism. If the real-time subscription fails, fall back to standard HTTP polling (REST API calls) every few seconds to keep the player state up to date. 

Related articles