HsMod 炉石传说增强插件完整上手指南:从 8 倍速动画到一键开包,50+ 项功能自由组合
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
晚上九点,你终于能挤出半小时开炉石。结果"正在连接"转了两圈,匹配成功,结算动画又慢得能泡完一杯茶;好不容易翻出几包卡没开,五连开光是在"点击—等待—再点击"之间来回倒腾,半小时还没进第一把正式对局。慢和碎,是炉石最磨人的两个地方。而HsMod就是冲着这两点来的:一款基于BepInEx框架的免费开源增强插件,给炉石注入50 多项可开关的功能——8 倍速变速齿轮、空格一键开五包、弹窗屏蔽、皮肤换装、对手情报、战棋统计,全都能按需组合,从安装到上手大约只需要十分钟。
先花三分钟把环境搭起来
安装的核心就三件事:拿到插件文件、搭好 BepInEx 运行环境、把插件放进指定目录。三个平台骨架相同,区别只在 DLL 来源和启动脚本写法。
Windows:三条命令 + 四个目录
如果你有.NET SDK 8.x,可以直接从源码编译:
git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore编译产物在HsMod/Release/HsMod.dll,这就是插件本体。项目里还带了一个install.bat,如果炉石默认安装目录里已经配好 BepInEx,它会直接把编译好的 dll 复制过去。不想折腾编译,也可以直接下载现成的HsMod.dll。
接下来按顺序做四小步:
- 下载BepInEx 5 的 x64 版本,解压到炉石传说根目录(
Hearthstone\); - 创建
Hearthstone\BepInEx\unstripped_corlib\目录,把项目里HsMod/UnstrippedCorlib下的所有DLL 复制进去; - 编辑炉石根目录的
doorstop_config.ini,把dll_search_path_override设为BepInEx\unstripped_corlib(旧版 BepInEx 用dllSearchPathOverride=BepInEx\unstripped_corlib); - 把
HsMod.dll放进Hearthstone\BepInEx\plugins,启动游戏。
进游戏后按Esc,如果菜单里多了一个Mod Settings(插件设置)按钮,说明插件已经成功挂载。
避坑指南:炉石的安装路径不能包含中文或任何非拉丁字符,否则插件加载会直接失败。这是新手翻车率最高的一步,动手之前先打开你的安装目录看一眼。另外注意 BepInEx 6 目前还是预发布、尚未适配,务必用 BepInEx 5;炉石客户端在 2026 年 7 月已全面转为 64 位程序,所以只选 x64 构建。
macOS 与 Linux:换条路,思路一样
macOS:下载 BepInEx 5 的 macOS 通用版解压到Hearthstone/;把HsMod/UnstrippedCorlibUnix里的 DLL 复制到/Applications/Hearthstone/BepInEx/unstripped_corlib/(Mono 和 Unity 版本需与炉石一致);编辑run_bepinex.sh,把dll_search_path_override指向BepInEx/unstripped_corlib,executable_name设为"Hearthstone.app",并把ARCHPREFERENCE改成"x86_64"——目前炉石还没有 arm64 构建,强制走 x86_64 才能保证跑起来。最后chmod u+x run_bepinex.sh,用./run_bepinex.sh启动。
Linux:先借助 hearthstone-linux 项目装好炉石(它通常会帮你配好client.config),再解压 BepInEx 5 的 Unix 版到根目录,同样复制UnstrippedCorlibUnix的 DLL。脚本里把executable_name设为"Bin/Hearthstone.x86_64",用sed -i "s/\r/ /g" ./run_bepinex.sh处理换行符,chmod u+x后运行即可。
温馨提示:macOS 和 Linux 涉及一个登录 token 的概念——从战网登录链接里复制
http://localhost:0/?ST=之后、&accountId=之前那一段,启动时作为参数传给脚本。在炉石根目录放一个client.config文件可以让 token 持久化,之后就能彻底绕开战网启动器,./Hearthstone.exe VerifyWebCredentials这种方式同样支持。
划重点:三个平台的核心都是"unstripped_corlib 备齐 + doorstop 指向 + 插件进 plugins",换平台只换 DLL 来源和脚本写法。
按场景挑功能,别让五十多个开关淹没你
装好之后先别急着把开关全打开。插件默认只加载基础能力,绝大多数功能都要你在设置里手动开启——逐项按场景勾选,出问题也好定位是哪一步引起的。设置入口就是游戏菜单里的Mod Settings按钮,里面带分类、搜索和按键绑定功能。
想提速:把等待时间压到极致
- 变速齿轮:原版齿轮拉不了几档,HsMod 支持8 倍速,极限可配置到32 倍速(
timeGear参数,负数还能变慢); - 帧率显示与锁定:界面实时显示 FPS(快捷键
左Ctrl+P),还能手动改游戏最大帧率,低配机器也能稳住流畅度; - 解除窗口限制:移除"窗口必须在前台"的焦点限制,切出去看网页、回消息不会导致游戏暂停;窗口大小也能自由拖拽;
- 快速战斗(战棋):跳过部分动画,比齿轮更顺滑,施法时的终结特效会被屏蔽,佣兵 PvE 也能用。
实战妙招:挂机党可以直接用命令行参数控制启动行为,无需进游戏手动配置,例如加afk=1进入挂机模板(启用插件+齿轮)、afk=4进入反挂机模式、afk=3只启用插件但禁用齿轮,afk=0则是全部禁用。
想省心:把机械操作交给插件
日常最耗耐心的从来不是对战,而是重复劳动。这套自动化模块就是为"点一下就完事"设计的:
- 快速开包:空格键一次开5 包,可选"开包时自动分解全额返尘卡牌",全程几乎不用碰鼠标;
- 一键分解:对已集齐的卡组一键自动分解返尘卡(需绑定快捷键);
- 自动领奖:竞技场、对决、佣兵等模式的奖励结算自动领取,直接帮你点开奖励包;
- 弹窗屏蔽:无法匹配提示、削弱补丁通知、广告推销、天梯结算奖励、对局结束推广、成就/佣兵宝箱奖励等弹窗,全部可按需关闭;
- 登录简化:支持
VerifyWebCredentials命令行登录,配合client.config完全绕开战网启动器,还能禁用掉线机制,长时间挂机不掉线。
避坑指南:自动分解、自动领奖这类功能一旦开启会直接消耗你的资源,建议先在备用号上验证一轮,确认行为符合预期再放到主号上跑。
想好看:皮肤与外观自由定制
皮肤模块把"个性化"拉到了插件能做的上限。配置文件HsSkins.cfg会在首次运行时自动生成(位于BepInEx\config\下),你能改的东西包括:
- 匹配界面英雄皮肤、酒馆内英雄皮肤;
- 终结特效、匹配面板、酒馆面板、幸运币;
- 卡背修改(进游戏自动生效);
- 自动金卡、强制钻石卡,以及佣兵的随机皮肤、强制钻石皮肤。
实战妙招:对局中想临时换皮肤,按
F4保存皮肤配置并模拟一次断线重连即可生效,不用退出对局。F4是固定快捷键,它还会顺带把游戏内信息 dump 到BepInEx目录、重启 Web 服务,其余快捷键都可以自定义。
想打得更明白:对战情报与社交增强
竞技向玩家会更喜欢这一组,它把"看不清对手"的信息差补上了:
- 对手完整战网昵称:不再只看半截名字,匹配界面还能直接加对手好友;
- 天梯段位显示:传说段位之前,结算前就能看到对手的段位;
- 标记对手已知卡牌:对局中"喂"给它的信息会被记录,它更像一本战术笔记本,而不是开挂式的全知工具;
- 战棋情报:排行榜浮层上显示每位玩家的 MMR(单人/双人分开、对局开始时后台加载);每场战棋的名次、分数增减、英雄会记入 CSV 并生成图表,支持今天/7天/本月/全部和单人/双人筛选;
- 战棋商店热键:刷新、冻结、酒馆升级、英雄技能、双人局查看队友棋盘,全部可重绑定,且只在购物阶段生效;
- 表情系统:开匹配自动静音所有对手表情(默认关闭)、屏蔽思考表情、屏蔽 Bob 语音、无冷却发表情(最小间隔1.5 秒)、快捷键发表情、一键静音炉石。
划重点:情报类功能的原理是"记录你看到过的信息",它只帮你记住,不会替你看见没见过的东西——这也是它和作弊工具的边界。
进阶玩法:把插件当瑞士军刀用
基础功能玩顺之后,这套插件还藏着几件"重器",适合喜欢拆开游戏看门道的玩家。
内置 Web 服务:数据尽收眼底
插件内置一个轻量 HTTP 服务(Showinfo),默认监听58744端口,且监听本机所有网卡 IP。浏览器打开http://localhost:58744,能看到佣兵养成进度、开包历史等数据;常用路径还有/config(网页改配置)、/about(关于页)。启动时加port=xxxx参数可以覆盖默认端口(命令行优先于设置项)。设置里启用后,还能访问/shell路径执行命令、调整配置——中文显示可能乱码,属于已知小毛病。
避坑指南:服务默认监听所有本地 IP,如果你把炉石装在云服务器上,务必在防火墙和安全组里管好 58744 端口,别让
/shell裸奔在公网。
模拟与开发工具:拆开游戏看门道
- 开发者模式:一键进入炉石 Developer Mode,探索卡牌机制的实现原理;
- 模拟开包:支持随机或指定结果,自定义卡包类型、数量、稀有度与质量,测手感、做演示都方便;
- 设备伪装:模拟 iOS、Android 等设备领取专属卡背(可能需要先打一局匹配);
- 冒险购买:用金币直接购买纳克萨玛斯、黑石山、探险者协会等冒险;卡拉赞支持强制开启(无法体验序章,关卡未清空前不能跳关);
- 静默对局:模拟断线/拔线(需绑定快捷键),观战好友时可自动切换双方视角,支持自动轮换卡组。
温馨提示:项目里还有两个辅助脚本:
GetHsLib.py用于更新炉石自身的运行时库(UnstrippedCorlib里的 DLL 版本要匹配);install.bat则负责把编译产物复制到默认炉石目录。它们不参与日常游戏,只在"环境维护"时用到。
实战妙招:多账号玩家启动时加
hsunitid=xxx参数,会为每个账号单独生成一份HsMod.cfg(存放在各自名下),互不干扰;debug参数则开启调试模式,排障时很有用。
出问题怎么自查:五分钟对照清单
出问题不可怕,可怕的是不知道从哪查起。大部分状况都能在这张表里对号入座:
| 症状 | 优先排查项 | 终极手段 |
|---|---|---|
| 插件完全不生效 | BepInEx 是否装好、unstripped_corlib是否完整、HsMod.dll是否在plugins下、日志是否显示 "Plugin HsMod is loaded" | 检查安装路径是否含中文字符;确认用的是 BepInEx 5 而非 6 |
| 配置改完保存不了 | 是否与其他炉石插件冲突(尤其改过Assembly-CSharp.dll的模组) | 禁用其他插件再试;冲突的补丁会导致 IL 偏移错位,所有补丁跟着失效 |
| 皮肤显示异常 | HsSkins.cfg格式是否正确、卡背/皮肤 ID 是否合法 | 删除HsMod.cfg让它重新生成默认配置 |
| Web 服务打不开 | Showinfo 是否启用、58744 端口是否被防火墙拦截、是否被port参数改过 | 查日志确认服务是否启动,确认监听地址与浏览器访问的 IP 一致 |
| 游戏更新后失灵 | 核心文件(如Assembly-CSharp.dll)是否变化 | 对照版本号规则判断是否真需要更新插件(见下节) |
划重点:遇到任何异常,第一招永远是"删掉
BepInEx\config\下相关的.cfg再重开游戏"——插件会自动生成一份全新默认配置,八成问题就此解决。还不行的话,反馈问题时附上HsMod.cfg,开发者才能定位。
读懂版本号与配置文件,心里有底
HsMod 用四段式版本号,以当前版本12.1.0.1为例:
- 第 1 位(12):炉石传说主版本号,对应 26 年的大版本;
- 第 2 位(1):炉石在该主版本内动了核心文件的更新次数(不映射炉石小版本,核心文件没变就不递增);
- 第 3 位(0):HsMod 针对该炉石版本新增功能的次数,第 2 位变化时归零;
- 第 4 位(1):编译号,主要记录 bug 修复。
由此推出一个能省事的结论:炉石更新不等于插件失效。只要Assembly-CSharp.dll这类核心文件没动,插件还能正常跑,就完全不用跟着 Release 更新。反过来,如果你同时装了别的 BepInEx 插件,注意同类方法被多次补丁时 HsMod 不会主动检测原始方法是否被改过,冲突了先停掉另一边。
配置文件方面,重点关注三个:
BepInEx\config\HsMod.cfg:主配置,所有功能开关都在这里;BepInEx\config\HsSkins.cfg:皮肤外观配置,首次运行自动生成;BepInEx\HsMatch.log:战棋对局统计日志,逗号分隔字段,路径可在设置里改。
温馨提示:游戏或插件大版本更新前,先把这三个文件备份一份。出问题时一键回滚,不用重新调教几十个选项。
多语言也值得说一句:HsMod/Languages/目录下躺着简体中文、繁体中文、英语、日语、韩语等 15 份 JSON 翻译,插件尚未完全翻译。觉得哪个词译得不顺,直接改对应 JSON 重新编译即可——这是参与项目门槛最低的方式之一。
边界与风险,玩之前先看清楚
社区方面,项目仍在活跃迭代,开发方向包括:游戏内一键更换英雄皮肤(目前只能靠模拟断线生效)、Showinfo 网页重构、macOS 适配完善、佣兵相关功能修复。源码里 HsMod/Patches/ 下的各类补丁、HsMod/WebServer.cs 的 Web 服务实现都很适合顺着读,有想法可以直接提交自己的改进或翻译。
合规与风险,请务必心里有数:
- 账号安全:中国大陆地区的炉石客户端默认会启动反作弊 SDK,HsMod 会尽力屏蔽相关检测,但无法 100% 保证账号安全——重度资源类功能(自动分解、自动领奖)建议只在备用号上验证;
- 协议与定位:项目遵循AGPL-3.0协议,明确定位为学习与研究用途;插件不收集任何用户信息;
- 分发渠道:HsMod 仅通过开源仓库分发,谨防第三方"加群领取"类诈骗。
从安装到上手,从 8 倍速开包到给自己酒馆里的英雄换个皮肤——路线图你已经拿到了。下一步,就是打开终端,把 dll 丢进plugins目录,亲自在结算动画上按一次空格,看看时间齿轮转到 8 倍时,那半小时能多出多少把对局。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考