État de la partie

Dans la plupart des cas, un tour de ChaCuN se déroule de manière extrêmement simple : le joueur courant tire la prochaine tuile du tas des tuiles normales et la place sur le plateau avant de poser éventuellement un occupant — pion ou hutte — sur l'une de ses zones. Ensuite, les points correspondants aux éventuelles forêts et rivières fermées par la pose de cette tuile sont attribués à leurs occupants majoritaires, et tous les occupants de ces aires sont retournés à leurs propriétaires. Le tour du joueur suivant peut alors commencer, sauf s'il ne reste plus de tuile à placer, auquel cas la partie se termine.

En pratique, un tour peut être plus compliqué que cela, en raison de l'existence des tuiles menhir et des pouvoirs spéciaux que certaines d'entre elles possèdent.

En effet, comme nous l'avons vu, lorsque le joueur courant ferme au moins une forêt contenant un menhir en posant sa tuile, alors il a le droit de jouer un second tour en plaçant cette fois une tuile tirée du tas des tuiles menhir — en supposant qu'il en reste. Parmi ces tuiles menhir, certaines ont un pouvoir spécial, et trois de ces pouvoirs impliquent d'effectuer immédiatement une action :

• le chaman donne au joueur qui le pose le droit de reprendre en main, s'il le désire, l'un des pions qu'il a posé précédemment sur le plateau,
• la pirogue permet au joueur qui la pose d'obtenir des points qui dépendent du nombre de lacs se trouvant dans le réseau hydrographique qui la contient,
• la fosse à pieux permet au joueur qui la pose d'obtenir des points qui dépendent des animaux présents dans le pré adjacent à la fosse, selon le principe décrit à la §2.2 ci-dessous.

Il faut noter que même si le joueur qui pose une tuile menhir ferme une forêt contenant un menhir, il n'a pas le droit à un troisième tour. Dès lors, un joueur joue toujours un maximum de deux tours avant de passer la main au joueur suivant.

Lorsqu'un joueur pose la tuile contenant la fosse à pieux, il obtient les points correspondants aux animaux présents dans le pré adjacent.

Pour déterminer ces points, on commence par compter le nombre d'animaux des différents types — mammouths, aurochs, cerfs et smilodons — présents dans le pré adjacent.

Ensuite, si le nombre de smilodons est supérieur ou égal au nombre de cerfs, alors on ignore tous les cerfs — car ils sont dévorés par les smilodons. Sinon, on ignore un nombre de cerfs égal au nombre de smilodons, pour la même raison.

Finalement, on calcule les points avec les animaux restants, un mammouth rapportant 3 points, un auroch 2 et un cerf 1.

Une fois les points décomptés, tous les animaux présents dans le pré adjacent à la fosse sont annulés (cancelled), c.-à-d. ignorés pour le reste de la partie. Dans le jeu physique — et dans l'interface graphique — ces animaux sont recouverts d'une croix indiquant leur annulation.

Une fois que la dernière tuile normale a été posée et que son placeur a terminé son tour — ou ses deux tours s'il a pu jouer une tuile menhir — le décompte final des points est effectué. Il consiste à attribuer aux joueurs possédant les occupants majoritaires des prés (chasseurs) et des réseaux hydrographiques (huttes de pêcheurs) les points correspondants aux aires qu'ils occupent, comme décrit ci-dessous.

Une partie de ChaCuN progresse au fur et à mesure que les joueurs effectuent les actions que l'on attend d'eux. Par exemple, lorsque la partie vient de commencer, le premier joueur doit tout d'abord placer la première tuile du tas des tuiles normales ; cela fait, il doit éventuellement l'occuper ; ensuite, le prochain joueur doit tirer et placer la prochaine tuile ; et ainsi de suite.

En d'autres termes, à chaque instant d'une partie, une action doit être effectuée pour que la partie puisse progresser. Nous en distinguerons cinq, auxquelles nous attribuerons des noms anglais concis qui apparaîtront aussi dans le code. Il s'agit de :

START_GAME

la tuile de départ doit être placée au centre du plateau et la tuile au sommet du tas des tuiles normales doit être retournée en vue d'être placée par le premier joueur,

PLACE_TILE

le joueur courant doit placer la tuile courante, qui est soit une tuile normale soit une tuile menhir,

RETAKE_PAWN

le joueur courant — qui vient de poser la tuile contenant le chaman — doit décider s'il désire ou non reprendre l'un des pions qu'il a posé précédemment sur le plateau, et si oui, lequel,

OCCUPY_TILE

le joueur courant — qui vient de placer une tuile — doit décider s'il désire occuper l'une de ses zones au moyen d'un des occupants qu'il a en main,

END_GAME

le décompte des points et l'annonce du ou des vainqueurs doit être faite, car le dernier joueur a terminé son (ou ses) tour(s) et le tas des tuiles normales est vide.

Une fois qu'une action a été effectuée, il est possible de déterminer la prochaine action qui doit l'être, et ce jusqu'à ce que la partie soit terminée. Par exemple, une fois que l'action PLACE_TILE a été effectuée, c.-à-d. que le joueur courant a placé la prochaine tuile, on peut déterminer que la prochaine action à effectuer est :

• RETAKE_PAWN si la tuile que le joueur vient de poser est celle contenant le chaman et qu'il possède au moins un pion sur le plateau, sinon
• OCCUPY_TILE si au moins une zone de la tuile que le joueur vient de poser peut être occupée, et qu'il a l'occupant nécessaire en main, sinon
• PLACE_TILE (tuile menhir) si le joueur a fermé, avec une tuile normale, au moins une forêt contenant un menhir, et qu'il reste encore une tuile menhir qu'il est possible de placer sur le tas correspondant, sinon
• PLACE_TILE (tuile normale, à placer par le joueur suivant) s'il reste encore une tuile normale qu'il est possible de placer sur le tas correspondant, sinon
• END_GAME.

Ces transitions entre les différentes actions à effectuer peuvent être représentées de manière graphique, comme ci-dessous.

Sur cette figure, chaque action à effectuer est représentée par un rectangle, et les flèches reliant ces actions représentent les transitions qui peuvent se produire entre elles. Pour ne pas alourdir le dessin, les transitions qui évitent OCCUPY_TILE car la dernière tuile posée ne peut pas être occupée ne sont pas représentées. Par exemple, il n'y a pas de flèche allant de PLACE_TILE (tuile normale) vers elle-même, alors que cette transition est possible, comme nous l'avons dit plus haut.

Pour faciliter la compréhension, les actions PLACE_TILE et OCCUPY_TILE apparaissent deux fois sur ce dessin : les occurrences de gauche correspondent au placement d'une tuile normale, celles de droite au placement d'une tuile menhir. En pratique, les actions consistant à placer ou occuper une tuile sont considérées comme les mêmes, indépendamment du type de la tuile en question.

Les actions START_GAME et END_GAME sont entourées deux fois car elles sont particulières : START_GAME est l'action de départ, celle qui doit être effectuée tout au début pour démarrer la partie, donc aucune flèche ne mène à elle ; END_GAME est quant à elle l'action de fin, après laquelle la partie est terminée et aucune autre action ne peut être effectuée, donc aucune flèche ne part d'elle.

Les règles de la version physique du jeu sont décrites :

• en français dans le livret de règles,
• en anglais sur le Wiki consacré à Carcassonne et ses variantes.

Il faut toutefois noter que les règles de notre version diffèrent parfois de celles du jeu original, principalement lorsque ces dernières sont ambiguës.

L'enregistrement GameState du paquetage principal, public et immuable, représente l'état complet d'une partie de ChaCuN. C'est-à-dire qu'il contient la totalité des informations liées à une partie en cours. Ses attributs sont :

• List<PlayerColor> players, la liste de tous les joueurs de la partie, dans l'ordre dans lequel ils doivent jouer — donc avec le joueur courant en tête de liste,
• TileDecks tileDecks, les trois tas des tuiles restantes,
• Tile tileToPlace, l'éventuelle tuile à placer, qui à été prise du sommet du tas des tuiles normales ou du tas des tuiles menhir, et qui peut être null si aucune tuile n'est à placer actuellement,
• Board board, le plateau de jeu,
• Action nextAction, la prochaine action à effectuer, le type Action étant décrit ci-dessous,
• MessageBoard messageBoard, le tableau d'affichage contenant les messages générés jusqu'à présent dans la partie.

Le type énuméré Action, public et imbriqué dans GameState, représente la prochaine action à effectuer dans la partie et contient les éléments suivants, dans l'ordre : START_GAME, PLACE_TILE, RETAKE_PAWN, OCCUPY_TILE et END_GAME.

Le constructeur compact de GameState se charge de garantir l'immuabilité de la classe et de valider les arguments en vérifiant que :

• le nombre de joueurs est au moins égal à 2,
• soit la tuile à placer est null, soit la prochaine action est PLACE_TILE,
• ni les tas de cartes, ni le plateau de jeu, ni la prochaine action, ni le tableau d'affichage ne sont nuls.

Pour faciliter la création de l'état initial d'une partie, GameState offre la méthode publique et statique suivante :

• GameState initial(List<PlayerColor> players, TileDecks tileDecks, TextMaker textMaker), qui retourne l'état de jeu initial pour les joueurs, tas et « créateur de texte » donnés, dont la prochaine action est START_GAME (donc la tuile à placer est null), et dont le plateau et le tableau d'affichage sont vides.

En plus de la méthode statique ci-dessus, GameState offre les méthodes d'instance publiques suivantes, qui permettent d'obtenir différentes informations au sujet de l'état de la partie :

• PlayerColor currentPlayer(), qui retourne le joueur courant, ou null s'il n'y en a pas, c.-à-d. si la prochaine action est START_GAME ou END_GAME,
• int freeOccupantsCount(PlayerColor player, Occupant.Kind kind), qui retourne le nombre d'occupants libres — c.-à-d. qui ne sont pas actuellement placés sur le plateau de jeu — du type donné et appartenant au joueur donné,
• Set<Occupant> lastTilePotentialOccupants(), qui retourne l'ensemble des occupants potentiels de la dernière tuile posée que le joueur courant pourrait effectivement placer — d'une part car il a au moins un occupant du bon type en main, et d'autre part car l'aire à laquelle appartient la zone que cet occupant occuperait n'est pas déjà occupée — ou lève IllegalArgumentException si le plateau est vide.

Finalement, GameState offre un certain nombre de méthodes dont le but est de gérer les transitions entre les différentes actions à effectuer. Ces méthodes sont destinées à être appelées uniquement lorsque la prochaine action à effectuer est une action spécifique, et leurs arguments sont les paramètres de cette action.

Par exemple, withPlacedTile, décrite plus bas, est destinée à être appelée lorsque la prochaine action à effectuer est PLACE_TILE, et elle prend donc en argument la tuile qui a été placée par le joueur courant. Elle effectue les éventuelles opérations nécessaires — p. ex. en attribuant les points correspondant à la pose de la tuile contenant la pirogue si c'est elle qui vient d'être posée — avant de déterminer la prochaine action à effectuer et de retourner l'état correspondant.

Ces méthodes — qui lèvent toutes une IllegalArgumentException (abrégée IAE dans leur description) si la prochaine action à effectuer n'est pas celle qu'elles attendent — sont :

• GameState withStartingTilePlaced(), qui gère la transition de START_GAME à PLACE_TILE en plaçant la tuile de départ au centre du plateau et en tirant la première tuile du tas des tuiles normales, qui devient la tuile à jouer ; lève IAE si la prochaine action n'est pas START_GAME,
• GameState withPlacedTile(PlacedTile tile), qui gère toutes les transitions à partir de PLACE_TILE en ajoutant la tuile donnée au plateau, attribuant les éventuels points obtenus suite à la pose de la pirogue ou de la fosse à pieux (voir la 3.1.1.1), et déterminant l'action suivante — qui peut être RETAKE_PAWN si la tuile posée contient le chaman ; lève IAE si la prochaine action n'est pas PLACE_TILE, ou si la tuile passée est déjà occupée,
• GameState withOccupantRemoved(Occupant occupant), qui gère toutes les transitions à partir de RETAKE_PAWN, en supprimant l'occupant donné, sauf s'il vaut null, ce qui indique que le joueur ne désire pas reprendre de pion ; lève IAE si la prochaine action n'est pas RETAKE_PAWN, ou si l'occupant donné n'est ni null, ni un pion,
• GameState withNewOccupant(Occupant occupant), qui gère toutes les transitions à partir de OCCUPY_TILE en ajoutant l'occupant donné à la dernière tuile posée, sauf s'il vaut null, ce qui indique que le joueur ne désire pas placer d'occupant ; lève IAE si la prochaine action n'est pas OCCUPY_TILE.

Notez que withStartingTilePlaced peut faire l'hypothèse que la première tuile du tas des tuiles normales peut toujours être posée, ce qui est effectivement le cas en pratique car la tuile de départ comporte au moins un bord de chacune des trois sortes — pré, forêt et rivière.

Comme d'habitude, nous ne vous fournissons plus de tests mais un fichier de vérification de signatures à importer dans votre projet.