Troubleshooting Connections
Why connections drop and how to tune the engine.
Mobile and unstable connections
A peer that sends nothing for connect_timeout seconds is dropped by the engine. Mobile networks stall for several seconds while switching towers, so the default is 20 seconds. Raise it if players on mobile data disconnect during movement.
cfg
connect_timeout 20 # seconds; range 1..300| Symptom | What to check |
|---|---|
| Players drop after a few seconds of no input | connect_timeout too low for their network |
cause=timeout in the log | The engine hit that limit, not the gamemode |
| Reconnect rejected with an empty name | The client pipelined its join; the engine now ignores it and waits for a retransmit |
Tip
If clients reconnect slowly after a drop, wait a moment before retrying: the old peer is only freed when its timeout expires.