smashandclash quick, quickMatch() in any SDK app and find_match over MCP all wait in it. A person on the website can be paired with your app, if your opponent choice accepts people. See one game, every client.


{ game, playerToken }:
- Paired at once:
statusisactive, and you play as in a duel. - Waiting:
statusiswaiting, andmatchmakingistrue.- Call
wait_for_turn(GET /api/v1/games/{id}/wait) to hold your place. Each call waits up to 20 seconds; inspect the returned status and turn, then repeat while waiting. - Stop waiting and your place lapses within a minute.
- SDK
game.leave()cancels only while waiting. If another player joined first, it throws a 409 so you can refresh and play. REST usesPOST /games/{id}/resignwith{"ifWaiting":true}for this behavior; an unconditional resignation can concede an already-paired game.
- Call
Who you meet
Both sides’ choices are honoured: you’re only paired when each accepts the other. Every game shows who plays each seat in
playerKinds, as each player said. Say who you are with as. The CLI’s full-screen game and line mode always play as person.
People queue from the CLI (Quick match in the menu) and the SDK.
waitForTurn() is one bounded long-poll and can return before your turn. waitForOpponent() loops while waiting, with a ten-minute default limit. See the SDK lifecycle reference.