1Setup
- Standard chessboard, classic starting position. The creator of a private game plays White; in quick match and against the computer, the army is drawn at random (or chosen against the computer).
- Full deck of 104 cards: for each of the four colors (red, blue, green, yellow) two copies of each value from 1 to 9, two “Skip”, two “Reverse”, two “+2”; plus four Jokers and four “+4”. Each card has a unique id. There are no 0 cards.
- The deck used in a game is filtered by the settings: highest number card (
maxCardNumber, 5 by default, from 1 to 9; 5 removes the 6 to 9) and whether Jokers are included (includeJokers). - The deck is shuffled on the server with cryptographic randomness. The order of the draw pile is never sent to the players.
2Playing a turn
A turn belongs to the army to move. The player controlling that army starts it. Phases:
- Start of turn, then draw: the player automatically draws the top card and reveals it to everyone (the draw is recorded before any notification).
- Immediate effect: the card’s effect applies at once (see section 4). For a +2 or a +4, a pawn placement phase comes before the moves.
- Moves: the number of moves granted by the card.
- End of turn: the move passes to the other army. The revealed card goes to the discard pile of the player who drew it.
A player with no legal move still reveals their card and applies its effect, then their turn ends.
3Draw pile and discard piles
- Each player has their own discard pile: it shows the cards they drew.
- When the draw pile is empty, both discard piles are shuffled together into a new draw pile.
- If the draw pile and discard piles are all empty, the player does not draw and plays one normal move.
4Card effects
| Card | Effect |
|---|---|
| 7Number 1 to 9 | The current player plays as many moves as the number (a series). |
| ↷Skip | The current player loses their turn without moving: the opponent immediately draws a card and plays it. |
| +2+2 | The player recovers 2 of their captured pawns (plus2Pawns) and places them back, then plays 1 move (movesAfterRecovery) experimental. |
| +4+4 | Same with 4 pawns (plus4Pawns). |
| ↻Reverse | The board flips: the White player becomes Black and vice versa. The position does not change. The current player continues their turn with their new army (1 move) experimental. In Purist mode, drawn in check, it hands the move straight to the opponent (section 5). |
| ♛Joker | The player plays 1 move, and any of their pieces may move like a queen (straight or diagonally, up to the first obstacle, captures included). Normal moves remain possible. A pawn reaching the last rank is promoted; it cannot move back onto its first rank experimental. |
Series rules (several moves):
- The first move is mandatory if one exists; the player may then end the series at any time.
- The same piece may move several times. No draw between moves.
- If no move is possible anymore, the series stops.
- In King Hunt mode, capturing the king ends the game immediately; in Purist mode, a check ends the series.
Pawn recovery (+2 / +4):
- Only pawns actually captured by the opponent are recovered (never more than the number captured).
- The player chooses the squares, only among the free squares of their starting rank (2 for White, 7 for Black): never on another rank. At most as many pawns are put back as there are free squares on that rank.
- With no captured pawn, or if the starting rank is full, the card simply grants 1 normal move; the captured pawns stay in reserve for a later +2 or +4.
- In Purist mode, a pawn put back that puts the enemy king in check ends the turn at once, as a check ends a series: the pawns not yet placed stay in reserve and the card’s moves are not played. A player whose king is still in check goes on, to parry. In King Hunt mode, if a pawn put back can take the enemy king, the automatic capture applies as soon as the moves begin.
Reverse: since there are no hands, only the armies are swapped. A Reverse neither grants nor extends an en passant right.
5Game modes: Purist and King Hunt
The mode is chosen before the game (private game, ranked queue or game against the computer) and locked during the game. The Elo rating is shared by both modes; the ranked queue only matches players who chose the same mode.
Purist mode
The rules of chess apply, adapted to the cards:
- No move may leave one’s own king in check: a pinned piece cannot leave its king’s line, the king never moves to an attacked square (so it cannot capture a defended piece), and the two kings can never stand side by side. This also applies to the Joker’s “queen” moves.
- The king is never captured.
- A check ends the series: as soon as a move — or a pawn put back — puts the enemy king in check, the turn passes to the opponent, who must get to answer it. Nobody ever plays while the enemy king is in check, except to parry a check to their own king.
- Reverse drawn in check: swapping the armies hands the check to the opponent (it is now their king that is attacked). The turn therefore ends at once, without a move: the opponent draws and must parry, or is checkmated.
- Checkmate: when a player has the move (after their draw), if their king is in check and no move allowed by their card parries the check, they are checkmated and lose the game. The card matters: a Joker or recovered pawns (+2, +4) can offer a parry that a plain move would not.
- No skipping a turn in check: a Skip drawn while one’s king is in check counts as 1 move, to parry. Likewise, if the configuration grants no move after recovering pawns (
movesAfterRecoveryset to 0) and the pawns put back do not parry the check, the player plays 1 move to parry. - Castling: classic rules, not allowed in check, through or into an attacked square.
- A player who is not in check but has no allowed move simply sees their turn end.
King Hunt mode
Chess-Uno’s original rules. You win by capturing the enemy king.
- You may leave your king on an attacked square, expose your king, move a “pinned” piece, or place the kings side by side. Nothing forces you to answer a threat to the king: the attack is information, it blocks no action.
- Check: when a king is attacked, “Check!” is shown to both players and the king’s square is highlighted. The player concerned can parry with their turn’s card.
- Automatic capture: if, when you have the move (after your draw, or during your series of moves), one of your moves can capture the enemy king, the game stops at once and you win, without having to play the capture. If your card gives you no move (a Skip), the king survives that turn.
- Capturing the king ends the game immediately and takes precedence over the remaining moves. A pawn capturing the king on the last rank does not choose a promotion piece: the game is over. The win goes to the current owner of the winning army (important after a Reverse).
- Castling: classic conditions (king and rook not moved, squares in between free); allowed from, through or into an attacked square.
In both modes
- Piece movements, obstacles, captures and promotions are those of chess.
- En passant: after a double step, the capture is only possible on the very next move, by the opposing army. Any other move, a fully skipped turn or an extra move by the same army (series) makes it expire.
6Series safeguard experimental
Setting stopComboOnKingThreat = true by default, adjustable in King Hunt mode (in Purist mode, a check always ends the series). When on, after each non-final move of a series, if the enemy king is attacked, the series stops and the turn passes to the other army. The attack is determined by the board’s moves and obstacles alone. This setting can be turned off before the game; it is locked during the game.
7Draws, resignation and disconnection
- The classic automatic draws (repetition, insufficient material, 50 moves) are disabled.
- Draw agreed by both players; resignation; draw after 10 consecutive turns without a piece moving experimental (threshold
drawAfterTurnsWithoutMove, reset by any move actually played). - Disconnection: in a game between humans, a disconnected player has a reconnection window (server setting, 60 s by default, shown in the game’s rules). Past that window without coming back, they forfeit. This window only exists in the server’s memory: a crash or restart never causes a forfeit, the game resumes from its saved state. A game against the computer can be resumed without any limit.
- Reconnecting or reloading never triggers a new draw: the full state is saved after every accepted command.
8What players see
Everyone sees: the board, the turn’s revealed card, the draw pile (count), each player’s discard pile, each army’s recoverable captured pawns, the armies controlled, pending effects, the player allowed to act, the remaining moves, the public log and connection states. The order of the draw pile and the server’s randomness are never sent. The computer only receives this same observation.
9Ranking
- Only finished games between two accounts are ranked, in both modes and with a shared rating; games against the computer do not count.
- Elo rating: 1000 at the start; a win against a higher-rated player earns more. The first 10 games count more (K = 40, then 24) to place a new player quickly.
- Tiers: 🥉 Bronze, 🥈 Silver (950+), 🥇 Gold (1050+), 🏆 Platinum (1200+), 💎 Diamond (1400+).
- Resignations and forfeits count as losses; a draw brings both ratings closer.
- For each pair of players, the head-to-head record (wins, losses, draws, recent form) is public.
10Configurable settings (default values)
| Setting | Default | Purpose |
|---|---|---|
gameMode | capture | game mode: purist (Purist) or capture (King Hunt) |
maxCardNumber | 5 | highest number card in the deck (1 to 9) |
includeJokers | true | Jokers included |
plus2Pawns / plus4Pawns | 2 / 4 | pawns recovered |
movesAfterRecovery | 1 | moves after the recovery |
stopComboOnKingThreat | true | series safeguard |
drawAfterTurnsWithoutMove | 10 | draw by inactivity |
reconnectGraceMs | 60000 | reconnection window (server) |


