# Règlement de Chess-Uno (prototype, version « carte révélée »)

Chess-Uno est un duel qui combine un échiquier et un paquet de cartes. Les joueurs **ne conservent aucune carte en main** : au début de chaque tour, le joueur pioche une carte, la révèle, et son effet s’applique immédiatement. Les règles ci-dessous sont celles réellement appliquées par le moteur. Les règles marquées **[expérimental]** sont des hypothèses de prototype : leurs valeurs sont centralisées dans la configuration (`RulesConfig`) et figées au début de chaque partie.

## 1. Mise en place

- Échiquier standard, position initiale classique. Le créateur d’une partie privée a les blancs ; dans la file rapide et contre l’ordinateur, l’armée est tirée au sort (ou choisie contre l’ordinateur).
- Paquet complet de **104 cartes** : pour chacune des quatre couleurs (rouge, bleu, vert, jaune) deux exemplaires de chaque valeur de 1 à 9, deux « Passe ton tour », deux « Inversion », deux « +2 » ; plus quatre Jokers et quatre « +4 ». Chaque carte a un identifiant unique. Il n’y a pas de carte 0.
- Le paquet utilisé dans une partie est **filtré par les réglages** : numéro maximal des cartes chiffrées (`maxCardNumber`, 5 par défaut, réglable de 1 à 9 ; 5 retire les 6 à 9) et présence des Jokers (`includeJokers`).
- Le paquet est mélangé côté serveur avec un aléa cryptographique. L’ordre de la pioche n’est jamais transmis aux joueurs.

## 2. Déroulement d’un tour

Un tour appartient à l’armée qui a le trait. Le joueur qui contrôle cette armée le commence. Phases :

1. **Début de tour** puis **pioche** : le joueur pioche automatiquement la carte du dessus et la **révèle** à tous (la pioche est enregistrée avant toute notification).
2. **Effet immédiat** : l’effet de la carte s’applique aussitôt (voir section 4). Pour un +2 ou un +4, une phase de **placement de pions** précède les déplacements.
3. **Déplacements** : le nombre de déplacements accordé par la carte.
4. **Fin de tour** : le trait passe à l’armée adverse. La carte révélée va à la défausse **du joueur qui l’a piochée**.

Un joueur sans déplacement possible révèle sa carte, subit son effet, puis son tour se termine.

## 3. Pioche et défausse

- Chaque joueur a **sa propre défausse** : on y voit les cartes qu’il a piochées.
- Quand la pioche est vide, les deux défausses sont remélangées ensemble pour former une nouvelle pioche.
- Si pioche et défausse sont vides, le joueur ne pioche pas et joue un déplacement normal.

## 4. Effets des cartes

| Carte | Effet |
| --- | --- |
| Chiffre 1 à 9 | Le joueur courant joue **autant de déplacements que le chiffre** (une série). |
| Passe ton tour | Le joueur courant **passe son tour** sans déplacement : l’adversaire pioche aussitôt une carte et la joue. |
| +2 | Le joueur **récupère 2 de ses pions capturés** (`plus2Pawns`) et les replace, puis joue 1 déplacement (`movesAfterRecovery`) **[expérimental]**. |
| +4 | Idem avec **4 pions** (`plus4Pawns`). |
| Inversion | **Le plateau s’inverse** : le joueur blanc devient noir et vice versa. La position ne change pas. Le joueur courant continue son tour **avec sa nouvelle armée** (1 déplacement) **[expérimental]**. En mode Puriste, piochée en échec, elle passe aussitôt la main à l’adversaire (section 5). |
| Joker | Le joueur joue **1 déplacement**, et **n’importe laquelle de ses pièces** peut se déplacer **comme une dame** (en ligne droite ou en diagonale, jusqu’au premier obstacle, capture comprise). Les coups normaux restent possibles. Un pion qui atteint la dernière rangée est promu ; il ne peut pas reculer sur sa première rangée **[expérimental]**. |

Règles des séries (plusieurs déplacements) :

- Le premier déplacement est obligatoire s’il en existe un ; le joueur peut ensuite **terminer la série** à tout moment.
- La même pièce peut être déplacée plusieurs fois. Aucune pioche entre les déplacements.
- Si plus aucun déplacement n’est possible, la série s’arrête.
- En mode Chasse au roi, la prise du roi arrête immédiatement la partie ; en mode Puriste, un échec arrête la série.

Récupération de pions (+2 / +4) :

- Seuls des pions **réellement capturés** par l’adversaire sont récupérés (jamais plus que le nombre capturé).
- Le joueur choisit les cases, **uniquement parmi les cases libres de sa rangée de départ** (2 pour les blancs, 7 pour les noirs) : jamais sur une autre rangée. On replace au plus autant de pions qu’il y a de cases libres sur cette rangée.
- Sans pion capturé, ou si la rangée de départ est pleine, la carte donne simplement 1 déplacement normal ; les pions capturés restent en réserve pour un prochain +2 ou +4.
- En mode Puriste, un pion replacé qui met le roi adverse en échec **arrête le tour aussitôt**, comme un échec arrête une série : les pions pas encore replacés restent en réserve et les déplacements de la carte ne sont pas joués. Un joueur dont le roi est encore en échec continue, pour parer. En mode Chasse au roi, si un pion replacé peut prendre le roi adverse, la prise automatique s’applique dès le début des déplacements.

Inversion : les mains n’existant plus, seules les armées sont échangées. Une Inversion n’accorde ni ne prolonge un droit de prise en passant.

## 5. Modes de jeu : Puriste et Chasse au roi

Le mode est choisi avant la partie (partie privée, file classée ou partie contre l’ordinateur) et figé pendant la partie. Le classement Elo est commun aux deux modes ; la file classée n’associe que des joueurs ayant choisi le même mode.

### Mode Puriste

Les règles des échecs s’appliquent, adaptées aux cartes :

- **Aucun coup ne peut laisser son propre roi en échec** : une pièce clouée ne peut pas quitter la ligne de son roi, le roi ne va jamais sur une case attaquée (il ne peut donc pas prendre une pièce défendue), et deux rois ne peuvent pas être voisins. Cela vaut aussi pour les déplacements « dame » du Joker.
- **Le roi ne se prend jamais.**
- **Un échec arrête la série** : dès qu’un coup — ou un pion replacé — met le roi adverse en échec, le tour passe à l’adversaire, qui doit pouvoir répondre. On ne joue jamais pendant que le roi adverse est en échec, sauf pour parer un échec à son propre roi.
- **Inversion piochée en échec** : l’échange des armées fait passer l’échec chez l’adversaire (c’est désormais son roi qui est attaqué). Le tour s’arrête donc aussitôt, sans déplacement : l’adversaire pioche et doit parer, sinon il est mat.
- **Échec et mat** : au moment où un joueur a la main (après sa pioche), si son roi est en échec et qu’aucun coup permis par sa carte ne pare l’échec, il est mat et perd la partie. La carte compte : un Joker ou des pions récupérés (+2, +4) peuvent offrir une parade qu’un simple déplacement n’offrirait pas.
- **En échec, on ne passe pas son tour** : un « Passe ton tour » pioché alors que son roi est en échec vaut 1 déplacement, pour parer. De même, si la configuration n’accorde aucun déplacement après la récupération de pions (`movesAfterRecovery` à 0) et que les pions replacés ne parent pas l’échec, le joueur joue 1 déplacement pour parer.
- **Roque** : règles classiques, interdit en échec, à travers ou vers une case attaquée.
- Un joueur qui n’est pas en échec mais n’a aucun coup permis voit simplement son tour se terminer.

### Mode Chasse au roi

Les règles d’origine de Chess-Uno. La partie se gagne en **prenant le roi adverse**.

- On peut laisser son roi sur une case attaquée, exposer son roi, déplacer une pièce « clouée », placer les rois côte à côte. Rien n’oblige à répondre à une menace sur le roi : l’attaque est une information, elle ne bloque aucune action.
- **Échec** : quand un roi est attaqué, « Échec ! » s’affiche chez les deux joueurs et la case du roi est mise en évidence. Le joueur concerné peut parer avec la carte de son tour.
- **Prise automatique** : si, au moment où tu as la main (après ta pioche, ou pendant ta série de coups), l’un de tes coups peut prendre le roi adverse, la partie s’arrête aussitôt et tu gagnes, sans avoir à jouer la prise. Si ta carte ne te donne aucun coup (un Passe ton tour), le roi survit ce tour-là.
- La prise du roi termine immédiatement la partie et prime sur les déplacements restants. Un pion qui prend le roi sur la dernière rangée ne choisit pas de pièce de promotion : la partie est finie. La victoire est attribuée au **propriétaire actuel** de l’armée gagnante (important après une Inversion).
- **Roque** : conditions classiques de non-déplacement du roi et de la tour et de cases intermédiaires libres ; autorisé depuis, à travers ou vers une case attaquée.

### Dans les deux modes

- Les déplacements des pièces, les obstacles, les captures et les promotions sont ceux des échecs.
- **Prise en passant** : après un double pas, la capture n’est possible qu’au déplacement immédiatement suivant, par l’armée adverse. Un autre déplacement, un tour entièrement passé ou un déplacement supplémentaire de la même armée (série) fait expirer cette possibilité.

## 6. Garde-fou sur les séries **[expérimental]**

Paramètre `stopComboOnKingThreat = true` par défaut, réglable en mode Chasse au roi (en mode Puriste, un échec arrête toujours la série). Lorsqu’il est activé, après chaque déplacement non terminal d’une série, si le roi adverse est attaqué, la série s’arrête et le tour passe à l’armée adverse. L’attaque est définie par les déplacements et obstacles du plateau seuls. Ce paramètre peut être désactivé avant la partie ; il est figé pendant la partie.

## 7. Nulles, abandon et déconnexion

- Les nulles automatiques classiques (répétition, matériel insuffisant, 50 coups) sont désactivées.
- Nulle acceptée par les deux joueurs ; abandon ; nulle après **10 tours consécutifs sans déplacement de pièce** **[expérimental]** (seuil `drawAfterTurnsWithoutMove`, réinitialisé par tout déplacement réellement effectué).
- **Déconnexion** : dans une partie entre humains, un joueur déconnecté dispose d’un délai de reconnexion (configuration serveur, 60 s par défaut, affiché dans les règles de la partie). Passé ce délai sans retour, il est déclaré forfait. Ce délai n’existe qu’en mémoire du serveur : une panne ou un redémarrage n’entraîne aucun abandon, la partie reprend depuis l’état persisté. Une partie contre l’ordinateur reste reprenable sans limite.
- Une reconnexion ou un rechargement ne provoque jamais de nouvelle pioche : l’état complet est persisté à chaque commande acceptée.

## 8. Ce que voient les joueurs

Chacun voit : le plateau, la carte révélée du tour, la pioche (nombre), la défausse de chaque joueur, les pions capturés récupérables de chaque armée, les armées contrôlées, les effets en attente, le joueur autorisé à agir, les déplacements restants, le journal public et les états de connexion. L’ordre de la pioche et l’aléa du serveur ne sont jamais transmis. L’ordinateur ne reçoit que cette même observation.

## 9. Classement

- Seules les parties terminées **entre deux comptes** sont classées, dans les deux modes et avec un classement commun ; les parties contre l’ordinateur ne comptent pas.
- Classement **Elo** : 1000 au départ ; une victoire contre un joueur mieux classé rapporte davantage. Les 10 premières parties comptent plus (K = 40, puis 24) pour placer vite un nouveau joueur.
- Paliers : 🥉 Bronze, 🥈 Argent (950+), 🥇 Or (1050+), 🏆 Platine (1200+), 💎 Diamant (1400+).
- Abandon et forfait comptent comme des défaites ; une nulle rapproche les deux classements.
- Pour chaque paire de joueurs, le bilan des confrontations directes (victoires, défaites, nulles, forme récente) est public.

## 10. Paramètres configurables (valeurs par défaut)

| Paramètre | Défaut | Rôle |
| --- | --- | --- |
| `gameMode` | `capture` | mode de jeu : `purist` (Puriste) ou `capture` (Chasse au roi) |
| `maxCardNumber` | 5 | numéro maximal des cartes chiffrées dans la pioche (1 à 9) |
| `includeJokers` | true | Jokers présents |
| `plus2Pawns` / `plus4Pawns` | 2 / 4 | pions récupérés |
| `movesAfterRecovery` | 1 | déplacements après la récupération |
| `stopComboOnKingThreat` | true | garde-fou sur les séries |
| `drawAfterTurnsWithoutMove` | 10 | nulle par inactivité |
| `reconnectGraceMs` | 60000 | délai de reconnexion (serveur) |
