Game Reference
All available games, their supported match types, bot difficulty levels, and game-specific result fields.
♟Chess
Classic two-player chess with clocks, AFK timeout, bot opponents, and full PGN history.
⚫Checkers
Standard checkers with forced captures, king promotion, and multi-jump moves.
🔴Connect 4
Drop pieces to connect four in a row — horizontally, vertically, or diagonally.
⭕Tic-tac-toe
Fast-paced 3×3 grid game. First to three in a row wins.
🏃Subway Runner
Endless runner with score tracking, lives, and distance leaderboards.
Available games
| game value | Name | Players | Match types | Bot | Extra result fields |
|---|---|---|---|---|---|
chess | ♔ Chess | 1–2 | matchmaking, private, bot | ✓ | pgn, moveCount |
checkers | ⚫ Checkers | 1–2 | matchmaking, private, bot | ✓ | moveCount |
connect4 | 🔴 Connect 4 | 1–2 | matchmaking, private, bot | ✓ | moveCount |
tictactoe | ⭕ Tic Tac Toe | 1–2 | matchmaking, private, bot | ✓ | — |
subway-runner | 🏃 Subway Runner | 1 | bot only | — | score, distance, coins |
Bot difficulty levels
All multiplayer games support bot opponents. Set matchType: "bot" and optionally pass botDifficulty in the WebSocket matchmaking join event.
| Difficulty | Chess depth | Behaviour |
|---|---|---|
| easy | 1 | 30% random moves. Occasional blunders. Responds in 0.5–1.5s. |
| medium | 3 | 15% suboptimal moves. Responds in 1–3s. |
| hard | 4 | Always plays the best move found. Responds in 2–5s. |
Result reasons
checkmateChess — king is in checkmate.resignationA player resigned mid-game.timeoutChess — a player ran out of time.disconnectPlayer disconnected and did not reconnect within 60 seconds.drawAgreed draw, stalemate, or move limit reached (checkers: 200 moves).game_overConnect 4 / Tic Tac Toe — board filled or four/three in a row.collisionSubway Runner — player hit an obstacle.Game-specific result fields
chess
pgn | string | Full PGN notation of the game. |
moveCount | number | Total half-moves (plies) played. |
checkers / connect4 / tictactoe
moveCount | number | Total moves played. |
subway-runner
score | number | Final score (coins × multiplier + distance bonus). |
distance | number | Distance run in metres. |
coins | number | Total coins collected. |
Beta Gamer GaaS API — questions? support@beta-gamer.com