# 斗地主游戏需求文档 ## 一、项目概述 ### 1.1 游戏定位 - **名称**:AI斗地主 - **类型**:Web 卡牌对战游戏 - **玩家**:1名人类玩家 vs 2名AI玩家 - **平台**:移动端优先(支持PC) ### 1.2 核心体验 - 经典斗地主玩法,规则简化易懂 - AI对手有策略性,不是随机出牌 - 流畅的发牌、出牌动画 - 清晰的游戏状态提示 --- ## 二、游戏规则(简化版) ### 2.1 牌组构成 - **总牌数**:54张(含大小王) - **牌点大小**:3 < 4 < 5 < 6 < 7 < 8 < 9 < 10 < J < Q < K < A < 2 < 小王 < 大王 ### 2.2 发牌规则 - 每人17张牌 - 剩余3张为底牌 - 叫地主后,底牌归地主所有(地主20张,农民各17张) ### 2.3 牌型定义(仅6种) | 牌型 | 说明 | 示例 | 大小比较 | |------|------|------|----------| | 单张 | 任意1张 | 3♠ | 点数大者胜 | | 对子 | 2张同点数 | 3♠3♥ | 点数大者胜 | | 三带一 | 3张同点数+1张单张 | 333+4 | 只比较三张部分 | | 顺子 | ≥5张连续单张 | 34567 | 点数大者胜,长度必须相同,不能含2和王 | | 炸弹 | 4张同点数 | 3333 | 炸弹>非炸弹 | | 王炸 | 小王+大王 | 大小王 | 最大 | ### 2.4 游戏流程 1. **发牌** → 17张/人 2. **叫地主** → 人类玩家选择是否当地主 3. **底牌** → 地主获得3张底牌 4. **出牌** → 地主先出,顺时针轮流 5. **结算** → 有人出完牌即结束 ### 2.5 胜负条件 - 地主先出完 → 地主胜 - 任一农民先出完 → 农民胜 --- ## 三、功能需求 ### 3.1 核心功能 #### 3.1.1 发牌系统 - [ ] 随机洗牌算法 - [ ] 发牌动画(17张牌依次发到3位玩家) - [ ] 底牌展示(3张背面朝上,确定地主后翻开) #### 3.1.2 叫地主 - [ ] 人类玩家:按钮选择"叫地主"/"不叫" - [ ] AI玩家:根据手牌强度自动决策 - [ ] 显示当前选择(如"P1叫地主,P2不叫") #### 3.1.3 出牌系统 - [ ] 人类玩家:点击选牌,系统自动识别牌型 - [ ] 牌型验证:非法牌型提示(如"这不是顺子") - [ ] 大小验证:不够大提示(如"管不上") - [ ] AI玩家:自动思考后出牌或"不出" - [ ] 出牌动画:牌从手牌区飞到桌面中央 #### 3.1.4 牌型识别 - [ ] 自动识别选中的牌是什么牌型 - [ ] 牌型合法性检查 - [ ] 与桌面牌比较大小 ### 3.2 UI功能 #### 3.2.1 牌桌布局 ``` +------------------------+ | [AI1: 17张] | ← 顶部:AI1玩家 | | | [AI2:17张] [桌面牌] | ← 左侧AI2,中央出牌区 | | | [人类玩家手牌区] | ← 底部:自己(正面朝上) | [出牌] [不出] [提示] | ← 操作按钮 +------------------------+ ``` #### 3.2.2 牌显示规则 | 位置 | 显示方式 | 交互 | |------|----------|------| | 自己 | 正面,扇形排列 | 可点击选择 | | AI | 背面,显示数量 | 不可操作 | | 桌面 | 正面,最新出牌 | 只读 | #### 3.2.3 动画效果 - [ ] 发牌动画:牌从牌堆飞到玩家位置 - [ ] 出牌动画:牌从手牌区飞到桌面中央 - [ ] 胜利动画:显示"你赢了"或"你输了" - [ ] 炸弹特效:屏幕震动 + 音效 ### 3.3 AI功能 #### 3.3.1 AI决策逻辑(非A*,采用规则型) **叫地主决策:** ``` 手牌评分 = 大牌数量(2/A/K) + 炸弹数量 + 顺子完整性 if 手牌评分 > 阈值: 叫地主 else: 不叫 ``` **出牌决策(优先级):** 1. 能管上且牌力刚好(不浪费大牌) 2. 出牌后剩余牌更容易走 3. 队友(农民)可能有的牌型 4. 必要时拆牌 **农民AI协作:** - 识别队友牌力(通过出牌历史) - 适当放牌给队友 - 拦截地主关键牌型 #### 3.3.2 AI难度等级 - [ ] 简单:随机出牌,偶尔出错 - [ ] 中等:基本策略,合理管牌 - [ ] 困难:记牌、算牌,最优决策 ### 3.4 游戏辅助功能 - [ ] 记牌器(显示剩余牌统计) - [ ] 提示功能(推荐可出的牌) - [ ] 托管功能(AI替人类玩家出牌) - [ ] 重新开局 --- ## 四、技术架构 ### 4.1 技术栈 - **引擎**:PlayCanvas(3D渲染)或 Canvas 2D - **语言**:JavaScript - **UI**:HTML + CSS ### 4.2 模块划分 ``` doudizhu/ ├── index.html # 主页面 ├── css/ │ └── style.css # 样式 ├── js/ │ ├── main.js # 游戏入口 │ ├── game.js # 游戏逻辑 │ ├── cards.js # 牌组管理 │ ├── player.js # 玩家类(人类+AI) │ ├── ai.js # AI策略 │ ├── ui.js # UI渲染 │ └── animation.js # 动画效果 └── assets/ ├── cards/ # 扑克牌素材 └── sounds/ # 音效 ``` ### 4.3 核心类设计 #### Game(游戏主类) ```javascript class Game { constructor() { this.deck = new Deck(); // 牌组 this.players = [ // 3位玩家 new Player(0, 'human'), // 人类 new Player(1, 'ai'), // AI1 new Player(2, 'ai') // AI2 ]; this.lordId = null; // 地主ID this.currentPlayer = 0; // 当前出牌玩家 this.desktopCards = null; // 桌面牌 this.gameState = 'init'; // 游戏状态 } start() { /* 开始游戏 */ } deal() { /* 发牌 */ } callLord() { /* 叫地主 */ } playCards(playerId, cards) { /* 出牌 */ } checkWin() { /* 检查胜负 */ } } ``` #### Player(玩家类) ```javascript class Player { constructor(id, type) { this.id = id; this.type = type; // 'human' | 'ai' this.cards = []; // 手牌 this.isLord = false; // 是否地主 } addCard(card) { /* 加牌 */ } removeCards(cards) { /* 出牌 */ } think() { /* AI思考 */ } // AI专用 } ``` #### CardType(牌型识别) ```javascript class CardType { static identify(cards) { /* 识别牌型 */ } static canBeat(cards1, cards2) { /* 比较大小 */ } static isLegal(cards, desktop) { /* 是否可出 */ } } ``` --- ## 五、数据结构 ### 5.1 单张牌 ```javascript { id: 0-53, // 唯一ID suit: 'spade', // 花色: spade|heart|club|diamond rank: 3-17, // 点数: 3-15(3-2), 16(小王), 17(大王) display: 'A♠' // 显示文本 } ``` ### 5.2 牌型 ```javascript { type: 'single', // 类型 cards: [...], // 包含的牌 value: 14, // 用于比较的值 length: 1 // 牌数量 } ``` ### 5.3 游戏状态 ```javascript { state: 'playing', // init|dealing|calling|playing|ended players: [ { id: 0, cardCount: 17, isLord: true }, { id: 1, cardCount: 17, isLord: false }, { id: 2, cardCount: 17, isLord: false } ], currentPlayer: 0, // 当前轮到谁 desktop: { // 桌面牌 playerId: 0, // 谁出的 cardType: {...} // 牌型 }, lastAction: 'play', // play|pass winner: null // 胜利者ID } ``` --- ## 六、UI设计规范 ### 6.1 色彩方案 - **背景**:深绿色(经典牌桌色)#0d5c3b - **牌背**:蓝色花纹 #1e3a5f - **高亮**:金色 #ffd700 - **按钮**:蓝色渐变 #2196F3 → #1976D2 ### 6.2 牌尺寸(移动端适配) - **宽度**:60px - **高度**:84px - **间距**:重叠显示(选中牌上移20px) ### 6.3 响应式布局 - **移动端**:竖屏,手牌扇形排列 - **PC端**:横屏,手牌水平排列 --- ## 七、开发计划 ### Phase 1:核心逻辑(3天) - [ ] 牌组生成与洗牌 - [ ] 发牌逻辑 - [ ] 牌型识别算法 - [ ] 大小比较算法 ### Phase 2:UI框架(2天) - [ ] 牌桌布局 - [ ] 牌的显示与交互 - [ ] 按钮与状态显示 ### Phase 3:游戏流程(2天) - [ ] 叫地主 - [ ] 出牌流程 - [ ] 胜负判断 ### Phase 4:AI实现(2天) - [ ] 叫地主AI - [ ] 出牌AI(基础版) - [ ] 记牌器 ### Phase 5: polish(2天) - [ ] 动画效果 - [ ] 音效 - [ ] 移动端适配 - [ ] Bug修复 **总计:约11个工作日** --- ## 八、风险与注意事项 ### 8.1 技术风险 1. **AI复杂度**:斗地主AI需要大量调优,初期可用简单规则 2. **移动端性能**:大量卡牌渲染需要优化 3. **浏览器兼容**:确保主流浏览器支持 ### 8.2 游戏体验 1. **AI不能太强**:否则玩家沮丧 2. **AI不能太弱**:否则没意思 3. **出牌要流畅**:动画不能卡顿 ### 8.3 替代方案 如果完整实现难度大,可先实现: - 单机版,跳过叫地主(随机选地主) - 简单AI(随机可出的牌) - 无动画版本 --- ## 九、参考资料 - [原始规则文档] Web 前端 + AI 三方斗地主规则及实现.md - 经典斗地主规则(QQ游戏/欢乐斗地主) --- **文档版本**:v1.0 **创建时间**:2026-04-04 **适用项目**:happy-games 斗地主游戏