一套面向英雄杀爱好者的本地客户端与 DIY 素材集合，让规则测试、武将调整和扩展创作更轻量。
| 下载游戏 | DIY教程 | 提交Bug |
|---|
HeroKill2016 是“太阳神2016英雄杀6+”的 Windows 本地客户端与资源集合。游戏围绕身份、武将技能、手牌管理和卡牌博弈展开，支持本地对局、AI 对战和局域网联机。项目重点保留 Lua 扩展能力，方便玩家调整技能、补充翻译、制作 DIY 武将和验证规则改动。
- ✨ 经典身份玩法
- ✨ 英雄杀武将包
- ✨ 多类型卡牌系统
- ✨ 内置 AI 对战
- ✨ Lua DIY 扩展
- ✨ 本地局域网联机
- ✨ 场景模式丰富
- ✨ 纯净本地运行
- 启动游戏：双击
QYxs.exe。 - 修改配置：编辑
config.ini，或在游戏内设置界面调整。 - 开启 AI：确认
config.ini中EnableAI=true。 - 调整模式：修改
GameMode或在客户端中选择模式。 - 添加扩展：把扩展 Lua 文件放入
extensions/，重启客户端。 - 查看模式说明：打开
scenarios/下对应的.html或.txt文件。
- 身份模式：以主公、忠臣、反贼、内奸等身份目标进行对抗。
- 3v3 模式：以队伍为单位进行更紧凑的战术对局。
- 双将模式：组合两名武将能力，形成更多技能联动。
- 场景模式：包含闯关、官渡、樊城、僵尸、情侣等特殊规则玩法。
项目包含英雄杀及扩展包中的多名武将，翻译与技能文本主要位于 lang/zh_CN/*Package.lua。
| 阵营/定位 | 说明 | 代表人物 |
|---|---|---|
| 君 | 偏核心、统率或主公定位的角色 | 嬴政、刘邦、李世民、朱元璋 |
| 臣 | 偏辅助、控制、响应和团队配合 | 商鞅、刘伯温、秦琼 |
| 民 | 偏爆发、单挑、扰乱或特殊机制 | 时迁、武松、西施 |
具体武将数量会随包和配置变化，建议以 lang/zh_CN/、游戏选将界面和启用包配置为准。
项目资源中包含基础牌、锦囊牌、装备牌和扩展牌图片，主要位于 image/card/、image/big-card/、image/equips/。
| 类型 | 说明 | 核心卡牌 |
|---|---|---|
| 基本牌 | 回合攻防与生存的基础 | 杀、闪、药 |
| 锦囊牌 | 控制、爆发、资源交换 | 决斗、烽火狼烟、探囊取物、釜底抽薪 |
| 装备牌 | 提供距离、攻击和防御能力 | 武器、防具、进攻马、防御马 |
- 在 Windows 环境下载或克隆本仓库。
- 确认根目录存在
QYxs.exe、QtCore4.dll、sanguosha.lua、image/、audio/。 - 双击运行
QYxs.exe。 - 如需测试新规则，把 Lua 扩展放入
extensions/。 - 如需打包发布版，运行：
pwsh -File scripts/build-release.ps1发布包会生成到：
dist/HeroKill2016-windows.zip
- Windows 10/11。
- PowerShell 7，用于本地脚本和打包。
- Lua 或 LuaC，用于执行
scripts/check-lua.ps1语法检查。 - Git，可选，用于版本管理。
说明：本仓库没有 C++/Qt 源码构建入口，当前无法从源码重新编译 QYxs.exe。CI 中的“构建”指校验 Lua 脚本并打包现有客户端和资源。
当前项目不提供源码编译步骤。可执行的本地验证与打包流程如下：
pwsh -File scripts/check-lua.ps1
pwsh -File scripts/build-release.ps1GitHub Actions 会在 Windows runner 上执行同样流程，并上传 HeroKill2016-windows.zip artifact。
以下是用 Lua 创建一个新武将的基本流程：
- 在
extensions/下新建my_hero.lua。 - 参考
extension-doc/1-Start.lua创建sgs.Package。 - 使用
sgs.General(extension, "hero_id", "kingdom")定义武将。 - 使用
sgs.CreateTriggerSkill、sgs.CreateViewAsSkill或sgs.CreateSkillCard编写技能。 - 在
lang/zh_CN/中补充武将名、技能名、技能描述和台词翻译。
最小扩展示例：
module("extensions.my_hero", package.seeall)
extension = sgs.Package("my_hero")
hero = sgs.General(extension, "my_hero", "qun")
my_skill = sgs.CreateTriggerSkill{
name = "my_skill",
events = {sgs.PhaseChange},
on_trigger = function(self, event, player, data)
return false
end
}
hero:addSkill(my_skill)本仓库包含一个勾践平衡补丁：
- 文件：
extensions/goujian_limit.lua - 效果：勾践在弃牌阶段或回合结束时，若手牌超过 20 张，须弃至 20 张。
- 说明：
lang/zh_CN/YXSPackage.lua和lang/zh_CN/Profile.lua已同步更新技能文本。
工作流文件：.github/workflows/ci.yml
CI 会执行：
- 检查关键运行文件。
- 安装 Lua。
- 检查 Lua 语法。
- 构建 Windows 发布 zip。
- 上传 artifact。
不是。当前仓库是已编译 Windows 客户端、Lua 脚本和资源集合，没有 C++/Qt 源码工程文件。
当前仓库只提供 Windows 客户端。其他平台没有可验证的运行方式。
把 Lua 扩展放到 extensions/，并在 lang/zh_CN/ 添加翻译。推荐先阅读 extension-doc/。
部分原版技能逻辑在 QYxs.exe 内部，Lua 仓库里只有翻译或 AI。遇到这种情况通常需要通过 Lua 补丁技能绕开。
进入 GitHub Actions，打开最新 CI 运行记录，在 Artifacts 中下载 HeroKill2016-windows。
- 🐛 反馈 Bug：提交复现步骤、截图文字或日志。
- 📝 完善文档：补充玩法说明、DIY 教程和常见问题。
- 🎨 补充素材：优化卡牌图、武将图、背景图和 UI 资源。
- 🔊 补充音效：整理技能、死亡、系统和背景音乐资源。
- 🧠 改进 AI：完善
lua/ai/中的出牌和技能判断。 - 🧪 测试规则：验证武将技能、模式规则和扩展兼容性。
本项目基于 MIT 许可证开源，仅供学习交流使用。
声明：本项目为非商业开源复刻/整理项目，与《英雄杀》官方无关。资源来源请以仓库实际提交记录、授权说明和贡献者说明为准。
如果觉得不错，别忘了给个 Star 支持一下。