Messages

Lorsque plusieurs éléments apparaissent en séquence — p. ex. des noms de joueurs ou d'animaux — ils sont toujours triés. Une fois triés, les éléments sont séparés par une virgule et un espace, sauf les deux derniers qui sont séparés par le mot « et ».

Les joueurs sont triés par couleur, dans l'ordre rouge, bleu, vert, jaune et pourpre. Ainsi, dans notre partie d'exemple, si un message contient les noms de tous les joueurs sauf celui de couleur bleue — p. ex. car ces joueurs viennent de remporter ensemble un certain nombre de points — alors les noms de ces joueurs sont donnés comme « Dalia, Bachir et Alice ».

Les animaux sont triés par valeur décroissante, c.-à-d. dans l'ordre mammouths, aurochs et cerfs. Les smilodons ne sont jamais mentionnés dans les messages, car leur seul rôle dans le jeu est de manger des cerfs.

Dans notre partie d'exemple, si la joueuse de couleur rouge ferme une forêt contenant un menhir, le message suivant est ajouté au tableau d'affichage :

Dalia a fermé une forêt contenant un menhir et peut donc placer une tuile menhir.

Dans notre partie d'exemple, si un joueur quelconque ferme une forêt composée de 3 tuiles, dénuée de champignons et dont le seul occupant majoritaire est le joueur de couleur bleue, le message suivant est ajouté au tableau d'affichage :

Claude a remporté 6 points en tant qu'occupant·e majoritaire d'une forêt composée de 3 tuiles.

Comme cet exemple l'illustre, le point médian (·) est utilisé pour tenir compte du fait que le genre des joueurs est inconnu. L'accord en nombre — c.-à-d. l'utilisation du singulier ou du pluriel — est par contre toujours fait conformément aux règles de la grammaire française.

Si les occupantes majoritaires sont les joueuses de couleur rouge et jaune, et que la forêt contient un groupe de champignons, le message ajouté est alors :

Dalia et Alice ont remporté 9 points en tant qu'occupant·e·s majoritaires d'une forêt composée de 3 tuiles et de 1 groupe de champignons.

Lorsqu'une rivière composée de trois tuiles mais dénuée de poissons est fermée et que ses occupants majoritaires sont les joueurs de couleur bleue et verte, le message suivant est ajouté au tableau d'affichage :

Claude et Bachir ont remporté 3 points en tant qu'occupant·e·s majoritaires d'une rivière composée de 3 tuiles.

Si l'occupante majoritaire est la joueuse de couleur jaune et que la rivière contient cinq poissons, le message ajouté est alors :

Alice a remporté 8 points en tant qu'occupant·e majoritaire d'une rivière composée de 3 tuiles et contenant 5 poissons.

Dans notre partie d'exemple, si le joueur de couleur verte place la fosse à pieux et que son pré adjacent contient un mammouth, deux aurochs et trois cerfs, le message suivant est ajouté au tableau d'affichage :

Bachir a remporté 10 points en plaçant la fosse à pieux dans un pré dans lequel elle est entourée de 1 mammouth, 2 aurochs et 3 cerfs.

Dans notre partie d'exemple, si la joueuse de couleur jaune place la pirogue dans un réseau hydrographique contenant quatre lacs, le message suivant est ajouté au tableau d'affichage :

Alice a remporté 8 points en plaçant la pirogue dans un réseau hydrographique contenant 4 lacs.

Si, à la fin de notre partie d'exemple, la joueuse de couleur rouge est l'occupante majoritaire d'un pré ne contenant aucun autre animal qu'un cerf, alors le message suivant est ajouté au tableau d'affichage :

Dalia a remporté 1 point en tant qu'occupant·e majoritaire d'un pré contenant 1 cerf.

Si les joueurs de couleur verte et bleue sont les occupants majoritaires d'un autre pré contenant un mammouth et deux cerfs mais aucun auroch, alors le message suivant est ajouté au tableau d'affichage :

Claude et Bachir ont remporté 5 points en tant qu'occupant·e·s majoritaires d'un pré contenant 1 mammouth et 2 cerfs.

Si, à la fin de notre partie d'exemple, la joueuse de couleur jaune est l'occupante majoritaire d'un réseau hydrographique contenant neuf poissons, alors le message suivant est ajouté au tableau d'affichage :

Alice a remporté 9 points en tant qu'occupant·e majoritaire d'un réseau hydrographique contenant 9 poissons.

Si tous les joueurs sauf la joueuse de couleur jaune sont les occupants majoritaires d'un réseau hydrographique contenant un poisson, alors le message suivant est ajouté au tableau d'affichage :

Dalia, Claude et Bachir ont remporté 1 point en tant qu'occupant·e·s majoritaires d'un réseau hydrographique contenant 1 poisson.

Si, à la fin de notre partie d'exemple, les joueurs de couleur jaune et verte sont les occupants majoritaires d'un pré contenant la grande fosse à pieux, et que dans son pré adjacent se trouvent deux mammouths, deux aurochs et deux cerfs, le message suivant est ajouté au tableau d'affichage :

Bachir et Alice ont remporté 12 points en tant qu'occupant·e·s majoritaires d'un pré contenant la grande fosse à pieux entourée de 2 mammouths, 2 aurochs et 2 cerfs.

Si la joueuse de couleur rouge est l'unique occupante majoritaire d'un pré contenant la grande fosse à pieux et que dans son pré adjacent ne se trouve aucun autre animal qu'un auroch, alors le message ajouté est :

Dalia a remporté 2 points en tant qu'occupant·e majoritaire d'un pré contenant la grande fosse à pieux entourée de 1 auroch.

Si, à la fin de notre partie d'exemple, les joueurs de couleur rouge et bleue sont les occupants majoritaires d'un réseau hydrographique contenant le radeau et dix lacs, le message suivant est ajouté au tableau d'affichage :

Dalia et Claude ont remporté 10 points en tant qu'occupant·e·s majoritaires d'un réseau hydrographique contenant le radeau et 10 lacs.

Si la joueuse de couleur jaune est l'unique occupante majoritaire d'un réseau hydrographique contenant le radeau et un lac, alors le message ajouté est :

Alice a remporté 1 point en tant qu'occupant·e majoritaire d'un réseau hydrographique contenant le radeau et 1 lac.

Si le joueur de couleur verte est l'unique gagnant de la partie avec un total de 111 points, alors le message suivant est ajouté au tableau d'affichage :

Bachir a remporté la partie avec 111 points !

Si les joueuses de couleur rouge et jaune sont ex æquo et remportent donc ensemble la partie avec 123 points, alors le message suivant est ajouté au tableau d'affichage :

Dalia et Alice ont remporté la partie avec 123 points !

Lorsque le joueur courant a la possibilité d'ajouter ou de reprendre un occupant, un message est affiché non pas sur le tableau d'affichage, mais à la place de l'image de la tuile à placer — étant donné qu'il n'y en a alors pas.

Lorsque le joueur peut placer un occupant, le message affiché est :

Cliquez sur le pion ou la hutte que vous désirez placer, ou ici pour ne pas en placer.

tandis que lorsque le joueur peut reprendre un pion — suite à la pose de la tuile contenant le chaman — le message affiché est :

Cliquez sur le pion que vous désirez reprendre, ou ici pour ne pas en reprendre.

Les méthodes de TextMakerFr doivent générer des chaînes de caractères composées de parties constantes et de parties calculées.

Il existe de nombreuses manières de construire ces chaînes : l'opérateur +, les bâtisseurs de chaînes, la méthode format de String, et ainsi de suite. Java 21 en offre une nouvelle, particulièrement puissante, que nous vous conseillons d'utiliser. Il s'agit des patrons de chaîne (string templates), qui permettent de construire une chaîne combinant des parties constantes et des parties calculées.

Un patron de chaîne ressemble à une chaîne constante, mais est précédé du préfixe STR. et peut contenir du code Java quelconque, entouré d'accolades et précédé d'une barre oblique inverse (\, backslash en anglais). Ce code Java est exécuté normalement, et sa valeur est convertie en chaîne au moyen de toString avant d'être inséré dans la chaîne. Par exemple, au lieu d'écrire :

String name = "Jean";
int points = 12;
String message = name + " a remporté " + points + " points.";

on peut écrire :

String name = "Jean";
int points = 12;
String message = STR."\{name} a remporté \{points} points.";

Il faut noter qu'en Java 21, les patrons de chaîne sont ce que l'on nomme une preview feature, c.-à-d. un concept en cours d'ajout au langage et susceptible de changer dans une version ultérieure. Ces preview features doivent être activées explicitement, ce qui dans IntelliJ peut se faire en changeant le « niveau de langage » en sélectionnant Project Structure… dans le menu File, puis en cliquant sur Project avant de changer le Language level à 21 (Preview) - String templates […].

Les patrons de chaîne sont relativement simples à utiliser et l'exemple ci-dessus devrait donc suffire, mais les personnes désirant en savoir plus à leur sujet pourront lire le document les décrivant, à savoir le JEP 430: String Templates¹.

Pour comprendre comment construire l'instance de SVGPath à retourner, lisez la documentation de la classe, en particulier celle de la méthode setContent, ainsi que celle des méthodes setFill et setStroke qu'elle hérite de sa classe-mère Shape.