团队课程项目

MachiKoro 桌游 C++ 实现

上海大学 · 算法与编程(2022 秋季)

用 C++14 实现支持 1~N 名玩家与 AI 的骰子桌游:15 种建筑、4 种地标、五色卡牌结算、市场购买与胜负判定。

项目背景

MachiKoro(街角小吃店)是一款骰子驱动的轻策略桌游。规则本身不复杂,但卡牌类型多、触发时机分散,很适合练面向对象建模。

这是上海大学 2022 秋季「算法与编程」的团队课程项目。我们用 C++14 从零实现了一个可在 Windows 控制台运行的单机版,支持 1~N 名人类玩家与 AI 混合对局。

简历版摘要

技术栈:C++14、STL、面向对象、UML、Visual Studio 2022、Git

  • 参与实现 MachiKoro 桌游核心:15 种建筑、4 种地标、五色卡牌结算、市场购买与胜负判定,支持 1~N 玩家与 AI 混合对局。
  • 使用 Card 抽象基类 + 五色卡继承体系,通过纯虚函数 action() 实现多态结算;结合 Singleton、简单工厂、Iterator 降低耦合。
  • 参与购买与结算流程重构,修复黄卡返回值、卡槽越界、紫卡触发条件、Shopping Mall 加成等 10+ 处逻辑/边界问题;实现防御式输入解析与 AI 自动决策。

实现内容

  • 15 种建筑 + 4 种地标:红、蓝、绿、紫、黄五类卡牌,完整结算规则
  • 五色卡牌体系:Card 抽象基类 + 五个子类,action() 纯虚函数实现多态结算
  • 回合流程:掷骰 → 红 → 蓝/绿 → 紫 → 建造 1 张建筑
  • 两种市场模式:origin 使用全部 15 种建筑,dlc 随机抽取 10 种
  • AI 对局:AI 可以自动完成掷骰、选择骰子数量、重掷与购买
  • 防御式输入:正则解析、单行输入、越界/余额/重复紫卡校验

我的工作

作为团队成员参与核心代码开发与调试,主要覆盖:

  • 卡牌继承体系与多态结算
  • 购买流程与边界校验
  • AI 决策候选集
  • 输入解析与文档整理

结果

项目可以完整编译运行,支持人类与 AI 混合对局。除源码外,还保留了 UML 类图、课程笔记、演示视频和旧版原型,记录从课程作业到可维护项目的演进过程。

源码与完整文档:https://github.com/yicongl1/Machikoro

技术文章

01 用 C++ 给桌游建模:卡牌体系与多态结算 Card 抽象基类、五色卡继承、action() 的上下文、结算顺序与地标建模。 02 桌游程序的边界:购买流程、索引与 AI PurchaseCode 返回值语义、先校验后扣钱、卡槽索引失效、AI 合法动作集与输入解析。 03 从课程作业到可维护项目:重构与归档 旧版原型的问题、重构顺序、UML/笔记/演示视频的归档,以及如果重做会怎么改。

相关技能

  • C++
  • Git
  • 项目管理