Règles du jeu¶

Plateau et points de tir¶

• Grille 10 × 8 (grid dans data/pieces.json). Repère : x de 0 à 9 vers la droite, y de 0 à 7 vers le bas, case (0,0) en haut à gauche.
• 36 points de tir sur le pourtour, générés par orapa_core::beam::entry_points (et répliqués côté client dans web/src/lib/points.ts).

     1  2  3  4  5  6  7  8  9  10
  A  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  11
  B  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  12
  C  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  13
  D  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  14
  E  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  15
  F  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  16
  G  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  17
  H  ·  ·  ·  ·  ·  ·  ·  ·  ·  ·  18
     I  J  K  L  M  N  O  P  Q  R

Un point sert à la fois d'entrée et de sortie : une onde qui quitte la grille est annoncée au point situé à cet endroit du bord.

Pièces¶

Cases et demi-cases¶

Une pièce est une liste de cases relatives {x, y, kind} :

Catalogue (data/pieces.json)¶

Formes de base (orientation 0), avec la notation de la démo CLI (· = vide dans la boîte englobante) :

Rouge   Jaune   Bleu / Blanc (grand triangle)   Blanc (losange) / Diamant   Corps noir
◥■◣     ■◤      ◥■■◤                            ◢◣                          ■■
        ◤·      ·◥◤·                            ◥◤

• Partie de base : red, yellow, blue, white1, white2 (5 pièces). Les options de lobby ajoutent diamond et/ou black (6 ou 7 pièces).
• Orientations : le moteur les génère à partir de la forme de base (4 rotations de 90°, plus leurs miroirs), puis supprime les doublons. On ne les liste jamais à la main.
• Dans l'interface, le bouton Pivoter (ou la touche R) fait défiler toutes les orientations, miroirs compris. Les flèches déplacent la pièce sélectionnée, Del ou Backspace la retire.

Contraintes de placement¶

Le moteur (orapa_core::validate_placement) renvoie toutes les violations, pas seulement la première. Il est appelé en direct dans le navigateur (WASM) pendant le placement, puis par le serveur à la réception de SetPlacement.

Le bouton Placement aléatoire valide demande au serveur un tirage qui respecte toutes les contraintes (tirage avec rejet, orapa_core::random_valid_placement).

Actions pendant la partie¶

À son tour, un joueur fait une action sur la grille adverse :

• Les résultats de toutes les actions (des deux joueurs) sont visibles dans l'historique.
• Côté client, un point déjà tiré ne peut pas être retiré : un clic dessus met son trajet en évidence. Le serveur, lui, accepte de retirer depuis le même point.
• Une proposition est comparée case par case au plateau secret (type de case, couleur, propriété spéciale), pas pièce par pièce. Deux placements qui donnent exactement le même plateau sont équivalents.

Trajet d'une onde¶

Modèle « centre de case » (crates/orapa-core/src/beam.rs) : l'onde avance de centre de case en centre de case, et entre ou sort par le milieu des côtés. Elle ne passe jamais par un sommet de la grille, donc les cas « coin exact » et « onde qui longe une arête » sont impossibles par construction.

À chaque case atteinte :

1. Case vide : l'onde continue tout droit.
2. Case occupée : la pièce compte comme touchée et sa couleur (si elle en a une) est ajoutée au mélange. Ensuite :
   • Corps noir : l'onde est absorbée (Absorbed), sans point de sortie ni couleur.
   • Carré, ou triangle touché par une cathète : demi-tour.
   • Triangle touché côté hypoténuse (l'onde entre par la moitié vide) : déviation à 90°.
3. Sortie de grille : résultat Exit { point, color }.
4. État (case, direction) déjà vu : boucle fermée, résultat Lost. Un nombre maximal de pas (4 × largeur × hauteur + 1) sert de filet de sécurité.

Mélange des couleurs¶

Fonction orapa_core::mix_colors : chaque couleur de gemme touchée compte une seule fois, quel que soit l'ordre.

Tours, vies et fin de partie¶

• Premier joueur : tiré au hasard quand les deux joueurs sont prêts. Le tour alterne ensuite après chaque action.
• Vies : 1 par défaut (règle officielle selon le code), ou 2 en option de lobby. Affichées sous forme de ♦.
• Limite de temps par tour (option : aucune, 30 s, 60 s, 120 s) : à l'expiration, une entrée Timeout est ajoutée à l'historique et le tour passe. Duel uniquement.

Mode solo (entraînement)¶

• Le serveur tire une disposition aléatoire valide (avec les extensions choisies). La partie démarre directement en phase de jeu, sans placement ni alternance de tours ni minuteur.
• Les vies s'appliquent : une proposition juste gagne. Si les vies tombent à 0, la partie se termine sans vainqueur (winner: null).
• Le bouton Voir la solution affiche la disposition sans terminer la partie (refusé par le serveur en duel).

Mode aide¶

• Option de lobby Mode aide (vérifie tes hypothèses), cochée par défaut dans le client.
• Pendant la partie, le joueur construit sa grille d'hypothèses (même éditeur que pour le placement). Le bouton Vérifier la cohérence rejoue localement, en WebAssembly, toutes ses ondes et ses sondages contre cette grille, puis liste les indices contredits (onde C, sondage (3,4)…).
• Ne consomme pas de tour. Aucune donnée secrète adverse n'est utilisée : seul l'historique public sert à la vérification.

Réactions¶

En duel, trois réactions rapides sont diffusées aux deux joueurs : « Bien joué ! » (gg), « Aïe ! » (oops), « Je réfléchis… » (think).