三国杀 - 文字版三国杀（Java）

项目说明

文字三国杀

开发完毕

文字版三国杀，java实现，10000+行

GUI+命令行两种运行模式

身份局，支持标准包+风火林山神将，模式为单机多人

符合checkstyle规则

纯属娱乐项目

by wzk

试玩！

前提条件

系统内安装jdk（版本1.8以上）

GUI运行

git clone或直接下载仓库，使用命令行（windows下可按下win+R输入cmd，mac下打开终端）进入下载目录，运行java -jar sgsgui.jar即可畅玩！

<img src="README.assets/image-730552.png" alt="image-730552" style="zoom: 33%;" />

<img src="README.assets/image-815869.png" alt="image-815869" style="zoom:33%;" />

命令行运行

同上，运行java -jar sanguosha.jar，即可命令行运行

<img src="README.assets/image-543760.png" alt="image-543760" style="zoom:33%;" />

自定义！

默认配置下使用全套卡牌+武将标准包，身份根据人数预先设定。在初始化时选择customize，即可自定义扩展包、身份分配、每个玩家可选的武将数量。

更新日志

* 6.5 初次commit
* 6.5 增加三尖两刃刀；修改了IO.chooseFromProvided；
* 6.5 增加丈八蛇矛、贯石斧；增加了useSkillInUsePhase接口（用于出牌阶段主动发动技能）
* 6.6 增加借刀、南蛮万剑、桃园五谷等锦囊牌；修改了Person.hurt；
* 6.6 牌堆CardsHeap.init中完成基本牌初始化
* 6.7 完成了CardsHeap.init中所有牌的初始化，可以玩🌶；修改了过拆、顺牵
* 6.7 通过测试修复了若干bug，增加若干IO输出；3000行撒花！💐
* 6.9 增加了注解技能类Skill及觉醒技、锁定技等（现学现用）；开始添加武将：郭嘉荀彧；
* 6.9 增加了国籍和身份（实际上是因为主公技而不得不加），可以打身份局🌶；增加了刘关张、曹操等武将
* 6.9 README中增加了更新日志；
* 6.10 增加了马超黄忠赵云（五虎将集齐）、诸葛亮黄月英（标包蜀国完成）；增加了牌数检查；修复了小bug
* 6.10 增加了司马懿夏侯惇；修复了死亡时未弃置所有牌的bug；更正了黄月英的性别；4000行打卡✌️
* 6.11 增加了许褚张辽甄姬（标包魏国完成）；对losecard和throwcard做小改动；修复了判定牌未进入弃牌堆的问题
* 6.11 武将类实现的PlayerIO接口，重构IO调用；增加孙权；增加限定技注解类
* 6.11 增加武器使用前询问；修改hurt参数（方便奸雄多张牌）；修改闪电；修正弃置装备牌数不匹配的问题；修正裸衣驱虎制衡
* 6.12 增加吕蒙黄盖甘宁；Person类属性全部移至Attributes类
* 6.12 增加周瑜大乔孙尚香陆逊吕布貂蝉华佗袁术（标包完成！！！）；修改judgeCard增加thisCard属性；
* 6.14 增加通过注解值打印技能列表的功能（学会反射√）；增加风包曹仁魏延夏侯渊周泰；5000行打卡✌️
* 6.14 增加小乔张角于吉、神吕蒙神关羽，风包完成！
* 6.15 完成火包（除神将）：典韦卧龙庞统袁绍庞德颜良文丑太史慈；6000行鼓掌👏
* 6.16 增加火包神将神周瑜、神诸葛亮
* 6.17 完成林包、神曹操神吕布；Person类与行动无关的方法全部移动至Attributes；GameManager与游戏运行无关的方法全部移动至具体卡牌或PlayerIO；修正无双；7000行！
* 6.18 增加姜维刘禅邓艾左慈；提取拆顺行为移动至PlayerIO；增加醒后技注解类
* 6.18 移动GameManager的askTarget至Card；PeoplePool中增加风火林山包武将；修改README
* 6.18 完成山包；8000行！
* 6.19 增加神司马神赵云；神话再临完成！
* 6.19 修复了神将的若干bug；武将和卡牌增加了help接口
* 6.19 全部代码移动至sanguosha包下；修复了chooseManyFromProvided
* 6.20 将大部分武器的逻辑移动至武器内部；修复了借刀、强袭、帷幕等若干bug
* 6.26 增加发行版jar包；增加对ctrl+d中断的响应；修改showHelp
* 6.28 增加GUI！swing现学现用~
* 6.28 修改IO输出方式（公开、私有）；修复若干bug
* 6.29 增加游戏人数、武将包自定义；完善了全局状态信息；endWithError修改为panic
* 7.1 10000行！！！重构IO；实现化身伪帝；完善help；修改GUI
* 7.2 基本完成！增加GUI启动页面，完善help，将左慈技能改为接口
* 7.2 修复了图片路径问题；修改README

功能介绍

本软件基于Java实现了文字版三国杀，其中包括了66个武将，41种手牌及若干其他功能类，共计147个类和接口，采用高度面向对象的设计方法实现，总行数达到10000行以上。同时，使用了swing开发了GUI作为游戏界面。代码经过仔细整理和重构，使用checkstyle检查，符合google的代码设计规范。

<img src="README.assets/image-440021.png" alt="image-440021" style="zoom: 67%;" />

主要实现了三国杀对战的功能，涵盖了上百种不同技能，可以进行单机多人对战、玩家挑战AI等，支持自定义游戏人数、身份配置、武将扩展包等功能。玩家通过键盘输入命令与程序交互，在屏幕上以文字形式展示游戏进行流程、全局每名玩家的状态、当前回合玩家的状态等信息。游戏中每名玩家依次执行自己的回合，打出卡牌或使用技能触发一系列复杂的判定过程，并实时判定游戏结束条件，在触发游戏结束条件时结束程序，输出获胜者。

整体架构

整体架构上，由GraphicLauncher调用GraphicRunner类的run方法启动游戏。该方法初始化游戏界面和ActionListener，随后初始化游戏内核GameLauncher，并通过JTextField组件的输入内容与游戏核心进行交互。

游戏内核GameLauncher调用游戏管理核心GameManager，完成初始化牌堆、分配身份、选择武将等步骤，并循环执行每个玩家的回合，直到触发游戏终止条件时，输出获胜者。

每名玩家的回合在其武将类Person的run方法中执行，依次进行回合开始阶段、判定阶段、摸牌阶段、出牌阶段、弃牌阶段、回合结束阶段。在此过程中会有多个触发技能的时机，此时会进入到武将子类的技能方法中（重写父类方法）执行。使用手牌（基本牌、锦囊牌、判定牌）时，会进入到该牌的判定过程中，将使用者与该牌的对象进行交互。

设计实现

管理类

#### GameManager

* 负责游戏宏观运行（每名玩家依次出牌、判定胜负条件、角色死亡等）
* 提供涉及到多个玩家的调用接口
* 铁索连环伤害
* 拼点
* 查询玩家之间的距离

如果将整个游戏理解为操作系统，那么GameManager相当于内核，提供系统调用帮助卡牌和武将完成功能。

#### IO

* 封装系统IO接口，例如输出卡牌信息、获得输入内容

#### Utils

* 提供常用工具包，例如断言、深拷贝、随机整数等

牌堆类

#### CardsHeap

* 游戏开始时初始化牌堆，分配手牌
* 负责牌堆和弃牌的管理，提供摸牌、弃牌与判定接口
* 牌堆为空时自动洗牌
* 为诸葛亮、神吕蒙等提供查看牌堆与操控牌堆的接口

#### PeoplePool

* 游戏开始时初始化武将牌，分配武将
* 游戏开始时为玩家分配身份
* 为左慈提供分配化身接口

人员类

#### SkillLauncher

接口，设定了一些技能发动时机的方法，默认均为空函数体，Person类实现该接口。若武将需要设置技能，可重写方法。

#### PlayerIO

接口，提供用户选择玩家（由GameManager代为完成）、选择选项、选择卡牌的接口（通过Person类实现PlayerIO接口实现）

#### Attributes

抽象类，设置了翻面、铁索连环、喝酒、死亡、性别、卡牌、装备牌、判定牌等相关属性，以及属性相关的操作，如摸牌弃牌、增减体力等，并内置了所有防具的处理逻辑。~~真实原因：Person类太臃肿了需要拆出一些不然过不了checkstyle。~~

#### Person

抽象类，所有武将的公共父类，武将行为的核心，属性全部封装在Attributes类中，并通过PlayerIO实现了IO接口，主要功能为回合内的完整流程，包括回合开始、判定、摸牌、出牌、弃牌、结束阶段等，核心逻辑为出阶段解析命令并使用卡牌、技能。

其余重要类

#### Sha

杀卡牌，继承自BasicCard，包含了杀伤害的属性（火、雷、普通）。调用大多数武器的功能（除诸葛连弩和丈八蛇矛在Person类中），并调用了各个杀相关的技能发动时机方法。

#### Card

抽象类，所有卡牌的公共父类，包括花色、点数、所有者、使用者、目标、[目标二]、是否已被取走（用于决定是否进入弃牌堆）等属性。核心行为是选择卡牌目标。

支持卡牌

基本牌

| 名称 | 已完成 |
| ---------------- | ------ |
| 杀（火杀、雷杀） | √ |
| 闪 | √ |
| 桃 | √ |
| 酒 | √ |

锦囊牌

#### 延时锦囊

| 名称 | 已完成 |
| -------- | ------ |
| 闪电 | √ |
| 乐不思蜀 | √ |
| 兵粮寸断 | √ |

#### 非延时锦囊

| 名称 | 已完成 |
| -------- | ------ |
| 决斗 | √ |
| 过河拆桥 | √ |
| 顺手牵羊 | √ |
| 无中生有 | √ |
| 无懈可击 | √ |
| 铁索连环 | √ |
| 火攻 | √ |
| 万箭齐发 | √ |
| 南蛮入侵 | √ |
| 桃园结义 | √ |
| 五谷丰登 | √ |
| 借刀杀人 | √ |

装备牌

#### 武器

| 名称 | 已完成 |
| ---------- | ------ |
| 雌雄双股剑 | √ |
| 青釭剑 | √ |
| 贯石斧 | √ |
| 青龙偃月刀 | √ |
| 麒麟弓 | √ |
| 寒冰剑 | √ |
| 古锭刀 | √ |
| 朱雀羽扇 | √ |
| 诸葛连弩 | √ |
| 丈八蛇矛 | √ |
| 三尖两刃刀 | √ |

#### 防具

| 名称 | 已完成 |
| -------- | ------ |
| 白银狮子 | √ |
| 藤甲 | √ |
| 仁王盾 | √ |
| 八卦阵 | √ |

#### 马

| 名称 | 已完成 |
| -------- | ------ |
| 骅骝 | √ |
| 绝影 | √ |
| 爪黄飞电 | √ |
| 的卢 | √ |
| 紫骍 | √ |
| 赤兔 | √ |
| 大宛 | √ |

武将

标准包

#### 魏国

| 名称 | 已完成 |
| ------ | ------ |
| 曹操 | √ |
| 郭嘉 | √ |
| 司马懿 | √ |
| 夏侯惇 | √ |
| 甄姬 | √ |
| 张辽 | √ |
| 许褚 | √ |

#### 蜀国

| 名称 | 已完成 |
| ------ | ------ |
| 刘备 | √ |
| 关羽 | √ |
| 张飞 | √ |
| 赵云 | √ |
| 马超 | √ |
| 诸葛亮 | √ |
| 黄月英 | √ |

#### 吴国

| 名称 | 已完成 |
| ------ | ------ |
| 孙权 | √ |
| 吕蒙 | √ |
| 黄盖 | √ |
| 甘宁 | √ |
| 孙尚香 | √ |
| 陆逊 | √ |
| 周瑜 | √ |
| 大乔 | √ |

#### 群雄

| 名称 | 已完成 |
| ---------- | ------ |
| 吕布 | √ |
| 貂蝉 | √ |
| 华佗 | √ |
| 袁术（SP） | √ |

风包

| 名称 | 已完成 |
| ------ | ------ |
| 黄忠 | √ |
| 魏延 | √ |
| 夏侯渊 | √ |
| 曹仁 | √ |
| 周泰 | √ |
| 小乔 | √ |
| 张角 | √ |
| 于吉 | √ |

火包

| 名称 | 已完成 |
| -------- | ------ |
| 荀彧 | √ |
| 典韦 | √ |
| 卧龙 | √ |
| 庞统 | √ |
| 太史慈 | √ |
| 袁绍 | √ |
| 庞德 | √ |
| 颜良文丑 | √ |

林包

| 名称 | 已完成 |
| ---- | ------ |
| 孙坚 | √ |
| 鲁肃 | √ |
| 孟获 | √ |
| 祝融 | √ |
| 曹丕 | √ |
| 徐晃 | √ |
| 董卓 | √ |
| 贾诩 | √ |

山包

| 名称 | 已完成 |
| -------- | ------ |
| 姜维 | √ |
| 刘禅 | √ |
| 邓艾 | √ |
| 左慈 | √ |
| 孙策 | √ |
| 张郃 | √ |
| 蔡文姬 | √ |
| 张昭张纮 | √ |

神将

| 名称 | 已完成 |
| -------- | ------ |
| 神吕蒙 | √ |
| 神关羽 | √ |
| 神周瑜 | √ |
| 神诸葛亮 | √ |
| 神曹操 | √ |
| 神吕布 | √ |
| 神赵云 | √ |
| 神司马懿 | √ |

UML图

仅展示了核心类和接口。其余类多数为核心类的子类。

<img src="README.assets/ER-7165250.png" alt="ER" style="zoom: 50%;" />

技术栈

开发语言：未知

项目类型：文字版三国杀（Java）

Star 数：0

功能特点

这是一套文字版三国杀（Java），代码结构清晰，适合开发者学习手机游戏的客户端渲染、服务端逻辑、网络通信与资源管理。项目涵盖了游戏的核心玩法、场景管理、角色与地图系统等模块，对理解手游的完整开发流程具有较高的参考价值。

从技术实现角度看，手游项目的难点在于：客户端与服务端的协议同步、资源热更新、场景切换与状态管理、以及多端适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / C# / PHP / Cocos / Unity 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入手游开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到手游的核心玩法实现、网络协议设计、场景与资源管理、以及游戏状态同步等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了手游项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整手游项目的架构，对后续开发其他实时对战类游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。