Unity Client Reconnection

TurnKit handles temporary socket drops automatically and supports restart-safe resume when you save a small reconnect snapshot. Pair this page with the Unity Client API and WebSocket reconnect behavior.

Socket Drop (App stays running)

TurnKit handles reconnection automatically. The client sends an automatic RECONNECT message with the last acknowledged move number. The server replays any missed moves via OnMoveMade and signals the end with OnSyncComplete.

What you need to do

• Wait until Relay.IsReady is true before sending any actions.
• If you need move history, store OnMoveMade events yourself.
• If you're using TurnKit server lists, replayed moves automatically rebuild list state. Refresh your UI from Relay.GetList(...) or Relay.AllLists after sync completes.
• If your game logic depends on the message.json payload, apply replayed moves without animations or wait times.

Game Crash or Restart

Automatic reconnection will not work because in-memory data is lost. To resume a match, save these values locally:

bool resumed = await Relay.Resume(playerId, slug, savedRelayToken, savedLastMoveNumber);

if (resumed)
{
    // Missed moves replay through OnMoveMade, then OnSyncComplete fires.
}
else
{
    // Fall back to normal matchmaking or join flow.
}

After a successful resume, the server replays missed moves followed by OnSyncComplete the same way as a normal reconnect.

Other Client Reconnection

The rules are the same for any client using the WebSocket protocol.