🀄 CMD-Mahjong (命令行杭州麻将)

一个基于 Node.js 和 WebSocket 实现的命令行麻将游戏，专注于杭州麻将规则。支持多玩家对战及 AI 机器人补位。

🌟 特色功能

• 杭州规则定制：
  • 白板财神：白板作为万能牌（财神），不可吃碰杠。
  • 爆头/财飘：支持胡牌逻辑判定。
  • 自模胡：严格遵循自摸胡规则（Fang Chong 默认关闭）。
  • 杠后摸尾：杠牌后从牌墙末尾补牌。
  • 七对子：完整支持七对子胡牌判定。
• 智能化：自带 AI 机器人，房间不满 4 人时可自动补位。
• 持久化设置：支持自定义昵称、语言切换（中/英），设置自动保存。
• 庄家系统：支持庄家连庄与轮转逻辑。
• 结算统计：每局结束显示分数变动、累计总分及胜场统计。

🚀 快速开始

1. 环境准备

确保您的电脑已安装 Node.js。

2. 安装依赖

在项目根目录运行：

npm install

3. 运行服务器

npx ts-node src/server/index.ts

服务器默认运行在 ws://localhost:8080。

4. 运行客户端

开启新的命令行窗口运行：

npx ts-node src/client/index.ts

🎮 操作说明

菜单界面

• [C]: 创建房间
• [J]: 加入房间
• [O]: 设置 (修改昵称/语言)
• [S]: 开始游戏 (仅房主)
• [Q]: 退出

游戏内操作

• [⬅️/➡️]: 选择手牌
• [⬆️]: 出牌
• [P]: 碰
• [K]: 杠
• [C]: 吃
• [H]: 胡
• [Space]: 过 (放弃当前操作)

🛠️ 技术栈

• Language: TypeScript
• Networking: WebSocket (ws)
• Environment: Node.js
• UI: CLI (readline / process.stdout)

📜 规则细节 (杭州麻将)

• 庄家规则：庄家胡牌或流局（平局）则连庄；闲家胡牌则由原庄家的下家坐庄。
• 结算分值：默认胜者 +30，败者 -10（后续可扩展底分与翻倍逻辑）。

---

Made with ❤️ by Antigravity