Maid Poker (女仆扑克牌)

A command-line multiplayer Dou Dizhu (斗地主) game built with Node.js and Socket.io.

Features

• Multiplayer: Host and join games over local network.
• Two Game Modes:
  • 三人斗地主 (1副牌, 标准规则)
  • 四人斗地主 (2副牌, 扩展规则)
• Beautiful UI: ASCII art for cards, special effects for Bombs, Planes, and Rockets.
• Interactive: Easy-to-use CLI interface.
• Rules: Complete Dou Dizhu rules with robust card validation.

Installation

npm install -g maid-poker-cli

Usage

Start the game:

maid-poker

Hosting

1. Select "创建游戏 (Host Game)".
2. Choose game mode (三人/四人斗地主).
3. Share your IP address with friends.
4. Wait for players to join.

Joining

1. Select "加入游戏 (Join Game)".
2. Enter the Host's IP address.
3. Enjoy!

Game Modes

三人斗地主 (Three Player Mode)

• 牌组: 1副牌 (54张)
• 发牌: 每人17张, 3张底牌
• 玩家: 3人 (1地主 vs 2农民)

牌型

| 牌型 | 说明 | 示例 | |------|------|------| | 单张 | 单张牌 | 7 | | 对子 | 两张相同 | QQ | | 三张 | 三张相同 | 888 | | 三带一 | 三张 + 1张单牌 | 888+6 | | 三带对 | 三张 + 1对 | 888+66 | | 顺子 | 5张及以上连牌 (不含2和王) | 34567 | | 连对 | 3对及以上连续对子 | 778899 | | 飞机 | 2组及以上连续三张 | 333444 | | 炸弹 | 4张相同 | 6666 | | 王炸 | 大王 + 小王 (最强) | 🃏🃏 |

四人斗地主 (Four Player Mode)

• 牌组: 2副牌 (108张)
• 发牌: 每人25张, 8张底牌
• 玩家: 4人 (1地主 vs 3农民)

新增/修改牌型

| 牌型 | 说明 | 示例 | |------|------|------| | 顺子 | 5张及以上连牌，可含2，不含王 | 34567, JQKA2 | | 四带二 | 4张相同 + 2张单牌 | 9999+6+8 | | 四带两对 | 4张相同 + 2对 | 9999+55+77 | | 王炸 | 大王 + 小王 | 🃏🃏 | | 八炸 | 8张相同牌 (2副牌独有) | 88888888 | | 天王炸 | 4张王 (最强) | 🃏🃏🃏🃏 |

炸弹大小顺序 (四人模式)

天王炸 (4王) > 八炸 (8张相同) > 王炸 (1大1小) > 普通炸弹 (4张相同)

同级别炸弹比较点数大小 (如 2222 > AAAA > KKKK...)

Development

# Install dependencies
npm install

# Run in development mode
npm start

# Run tests
npm test

# Build for production
npm run build

Testing

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

License

ISC