docs: compléter le README avec les règles des bâtiments et cartes Événement

Dernier point de la checklist de la fonctionnalité Cartes Événement
(pioche partagée, ciblage, synergies) resté en suspens. Ajout également des
règles des Bâtiments (Église, Château Royal), qui n'avaient jamais été
documentées lors de leur implémentation précédente. Mise à jour de
l'arborescence du projet dans la section Structure.
This commit is contained in:
Kevin L'Hereec committed 2026-08-24 13:27:15 +02:00
1 parent 44d4eb7e96
commit c9b4a7e567
1 file changed
+28 -2
+28 -2
View File
@@ -15,14 +15,14 @@ regnum/
├── client/ # Vue 3 + Phaser 3
│ ├── src/
│ │ ├── views/ # HomeView, LobbyView, GameView
│ │ ├── game/ # Scènes Phaser (Boot, Game) + objets + items
│ │ ├── game/ # Scènes Phaser (Boot, Game) + objets + items/buildings/events
│ │ ├── stores/ # Pinia store
│ │ ├── services/# Socket.io client
│ │ └── utils/ # Fonctions pures partagées (HUD, etc.)
│ └── test/unit/ # Tests unitaires Vitest (store, utils)
├── server/ # Node.js
│ ├── src/
│ │ ├── game/ # Room, RoomManager, cards, items
│ │ ├── game/ # Room, RoomManager, cards, items, buildings, events
│ │ └── index.js # Serveur Express + Socket.io
│ └── test/game/ # Tests unitaires node:test (moteur de jeu)
└── e2e/ # Tests d'intégration Playwright (client+serveur réels)
@@ -130,6 +130,32 @@ Pendant la phase de sélection, un joueur peut dépenser des points d'une jauge
En cas de conflit (plusieurs joueurs achètent le même objet le même tour), c'est le joueur le plus proche du **"premier joueur"** du tour (rôle qui tourne entre les joueurs à chaque tour) qui l'obtient ; les autres conservent leurs points.
### Bâtiments achetables
Comme les objets, mais un bâtiment coûte des points sur **deux jauges à la fois** et garantit un minimum sur chacun de ses deux attributs à chaque tour, avec un **bonus de synergie** (+1 supplémentaire) si l'objet lié au même attribut est aussi possédé par le joueur. Un seul exemplaire de chaque bâtiment existe pour toute la partie, avec la même règle de priorité que les objets en cas de conflit d'achat.
| Bâtiment | Coût | Effet de base | Synergie |
|---|---|---|---|
| Église | 3 🟢 Santé + 2 🔵 Diplomatie | +1 Santé et +1 Diplomatie garantis chaque tour | +1 Santé supplémentaire si la Trousse du Médecin est possédée ; +1 Diplomatie supplémentaire si le Sceau Royal est possédé |
| Château Royal | 3 🟡 Nourriture + 2 🔴 Guerre | +1 Nourriture et +1 Guerre garantis chaque tour | +1 Nourriture supplémentaire si la Charrue est possédée ; +1 Guerre supplémentaire si le Trébuchet est possédé |
### Cartes Événement
En plus de sa carte personnage, un joueur peut piocher et jouer des cartes Événement à chaque tour :
- **Pioche** : en phase de sélection, un joueur peut acheter une pioche pour un coût fixe de **1 point dans chacune des 4 jauges**, une seule tentative par tour. La carte piochée provient d'un **deck partagé** de 18 cartes (3 exemplaires de chacun des 6 événements ci-dessous), mélangé au démarrage de la partie et commun à tous les joueurs.
- **Main d'événements** : les cartes piochées mais pas encore jouées s'accumulent dans une main personnelle limitée à **2 cartes**. Un joueur choisit librement, tour par tour, de jouer l'une de ses cartes (au maximum une par tour) ou de la garder.
- **Résolution** : toutes les cartes Événement jouées un même tour sont résolues **avant** le calcul des gains des cartes personnage (les jauges reflètent donc déjà leurs effets au moment de la comparaison des personnages). Une carte jouée est toujours défaussée après résolution, qu'elle ait ou non atteint son plein effet.
| Événement | Effet | Synergie |
|---|---|---|
| Récolte exceptionnelle | +2 Nourriture | +1 Nourriture supplémentaire avec la Charrue |
| Épidémie | Tous les joueurs perdent 1 Santé | Avec la Trousse du Médecin : un adversaire choisi perd 2 Santé à la place. Avec l'Église (prioritaire sur la Trousse) : tous les adversaires perdent 2 Santé à la place |
| Levée des troupes | +2 Guerre, -1 Diplomatie | +2 Guerre supplémentaires avec le Trébuchet (soit 4 Guerre au total) |
| Accord royal | +1 Diplomatie pour soi ; un joueur choisi gagne 1 Diplomatie ; un joueur choisi (peut être différent) perd 1 Diplomatie | +1 Diplomatie supplémentaire avec le Sceau Royal |
| Complot découvert | Jusqu'à la fin du tour, annule pour son porteur les effets négatifs des autres cartes Événement jouées ce tour | — |
| Grande fête au château | +1 Nourriture, +1 Diplomatie | Pioche 1 carte Événement supplémentaire avec le Château Royal |
### Fin de partie
Le joueur avec le score total (somme des 4 jauges) le plus élevé après 12 tours remporte la partie.