Projet de cours en équipe

Jeu de société MachiKoro en C++

Université de Shanghai · Algorithmes et programmation (automne 2022)

Un jeu de société de dés en C++14 pour 1 à N joueurs et des IA : 15 bâtiments, 4 monuments, règlement des cartes en cinq couleurs, achats sur le marché et conditions de victoire.

Contexte

MachiKoro est un jeu de société léger piloté par les dés. Les règles ne sont pas très complexes, mais les types de cartes sont nombreux et leurs effets se déclenchent à des moments différents — un bon exercice de modélisation orientée objet.

C’était un projet de cours en équipe pour Algorithmes et programmation à l’Université de Shanghai, à l’automne 2022. Nous avons développé en C++14 une version console Windows pour 1 à N joueurs humains et des IA.

Résumé (version CV)

Stack : C++14, STL, POO, UML, Visual Studio 2022, Git

  • Participation au cœur de MachiKoro : 15 bâtiments, 4 monuments, règlement des cinq couleurs, achats sur le marché et conditions de victoire, pour 1 à N joueurs humains et IA.
  • Conception d’une classe abstraite Card et de cinq sous-classes de couleur, avec règlement polymorphe via action() ; Singleton, fabrique simple et Iterator pour réduire le couplage.
  • Refonte des achats et du règlement : correction de plus de 10 problèmes de logique et de limites (valeur de retour des cartes jaunes, indice de marché hors bornes, déclenchement des cartes violettes, bonus Shopping Mall) ; analyse défensive des entrées et décisions autonomes de l’IA.

Ce que nous avons réalisé

  • 15 bâtiments + 4 monuments, avec les règles complètes de règlement des cinq couleurs
  • Hiérarchie de cartes : classe abstraite Card et cinq sous-classes, avec action() en fonction virtuelle pure
  • Déroulement d’un tour : lancer de dés -> rouge -> bleu/vert -> violet -> construire un bâtiment
  • Deux marchés : origin utilise les 15 bâtiments, dlc en tire 10 au hasard
  • IA : elle peut lancer les dés, choisir le nombre de dés, relancer et acheter seule
  • Entrées défensives : analyse par expressions régulières, saisie sur une ligne, contrôles de bornes, de solde et de doublons

Mon rôle

Membre de l’équipe, j’ai participé au développement et au débogage du cœur du projet, notamment :

  • la hiérarchie des cartes et le règlement polymorphe
  • le flux d’achat et les contrôles de limites
  • l’ensemble des actions légales de l’IA
  • l’analyse des entrées et la documentation

Résultat

Le projet se compile et se joue de bout en bout, avec des parties mixtes humains/IA. Outre le code, le dépôt conserve le diagramme UML, les notes de cours, les vidéos de démonstration et le prototype initial, qui documentent l’évolution du devoir vers un projet maintenable.

Code et documentation : https://github.com/yicongl1/Machikoro

Notes techniques

01 Modéliser un jeu de société en C++ : cartes et règlement polymorphe La classe de base Card, les cinq sous-classes de couleur, le contexte de action(), l'ordre de règlement et la modélisation des monuments. 02 Les cas limites d'un jeu : achats, indices et IA Sémantique de PurchaseCode, valider avant de modifier, invalidation des indices de marché, actions légales de l'IA et analyse des entrées. 03 D'un devoir de cours à un projet maintenable : refonte et archivage Les problèmes du prototype, l'ordre de la refonte, l'archivage UML/notes/démos et ce que je changerais ensuite.

Compétences associées

  • C++
  • Git
  • Gestion de projet