Matchmaking and Reconnection
Use this reference for room discovery, filtering, and reconnect workflows.
Matchmaking Rules
- Set room metadata in
onCreatefor mode/region/skill filters. - Use metadata and seat availability in matchmaking selection.
- Keep metadata consistent with room runtime state.
Reconnection Pattern
- In
onDrop, mark player as disconnected. - Allow reconnection for a bounded timeout.
- Restore session if token is valid.
- Expire and remove player if timeout passes.
Example Timeout Policy
- Casual match: 20-30 seconds grace.
- Ranked match: 10-15 seconds grace.
- Tournament: strict policy with admin override.
Operational Checks
- Reconnected clients rebind to prior player state.
- Duplicate sessions for same player are rejected.
- Expired reconnection tokens are invalidated.