Sessions & Config

AFK timeout config

A per-session override for how long an inactive player's turn runs before they're forfeited. Optional — pass nothing and the game's own default applies.

On session creation

json

{
  "game": "ludo",
  "afkConfig": { "timeoutMs": 20000, "warnMs": 15000 },
  "players": [ { "id": "user_1" }, { "id": "user_2" } ]
}

Bounds

timeoutMs is clamped to 5,000–300,000ms. warnMs must fire before timeoutMs — if it doesn't, it's silently clamped down to satisfy that ordering rather than the request being rejected.

Only ludo has a registered AFK default right now. Sending afkConfig for any other game is silently ignored — same as not sending it at all — rather than causing an error. As more games register a default, this page will list them here.

← Previous

Sessions API

Custom Game Rules