HsMod 完全上手指南:5 分钟装好,8 倍速开包
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
以前开五包卡,点一下、等半天、再点一下,光动画就烧掉一分钟;现在启用快速开包,空格一按,3 秒翻完五包。HsMod 是基于 BepInEx 的炉石传说免费开源增强插件,给普通玩家提供 50+ 项默认关闭的功能,覆盖提速、自动化、皮肤和对战情报。
自选路径
你的目标决定入口,不用通读全文。
| 你想干的事 | 直接去哪 |
|---|---|
| 只想装上跑起来 | 「五分钟装好并跑起来」 |
| 想开关功能、调皮肤外观 | 「图形界面层」「配置层」两节 |
| 想用脚本化、服务器化启动 | 「命令行与 Web 层」 |
五分钟装好并跑起来
优先从项目 Release 页面拿现成的HsMod.dll;想用源码自己编译(需 .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看到插件本体。接下来搭运行环境,四步:
- 把 BepInEx 5 的 x64 版解压到炉石传说根目录;
- 把
HsMod/UnstrippedCorlib下所有 DLL 复制到Hearthstone\BepInEx\unstripped_corlib\; - 在
doorstop_config.ini里设dll_search_path_override = BepInEx\unstripped_corlib; - 把
HsMod.dll放进Hearthstone\BepInEx\plugins,启动游戏。
⚠️ 炉石安装路径不能含中文或其他非拉丁字符,否则插件不加载,这是新手翻车率最高的一步。 ⚠️ 客户端 2026 年 7 月起是 64 位程序,必须用 BepInEx 5 的 x64 构建,BepInEx 6 尚不适配。
启动后按Esc,主菜单出现Mod Settings按钮即算成功。macOS / Linux 改用HsMod/UnstrippedCorlibUnix的 DLL 加run_bepinex.sh启动脚本,思路完全一样,细节看仓库根目录ReadMe.md的 Installation 部分。
图形界面层:从游戏内菜单开功能
30秒速赢:按Esc打开主菜单,点Mod Settings。面板带分类、搜索和按键绑定捕获,所有开关一目了然,改完即存。
- 时间加速:默认 8 倍速,可配到 32 倍,需先开启时间齿轮总开关;
- FPS 显示与锁帧:屏幕实时显示帧率,手动修改游戏最大帧率;
- 解除窗口焦点限制:切出去看网页游戏不暂停,窗口大小可自由拖;
- 快速开包:空格一次开 5 包,可选自动分解全额返尘的重复卡;
- 一键分解:对已集齐的卡组自动返尘,需要先绑定快捷键;
- 弹窗屏蔽:无法匹配、削卡通知、广告、天梯结算奖励逐个关闭。
💡组合技:挂机开包= 时间加速 8 倍 + 快速开包 + 自动分解全额返尘卡。空格开 5 包,手不用碰鼠标,重复卡自动回炉,全程无人值守。
这层适合谁:不想碰任何配置文件的人,菜单开关能覆盖日常八成场景。
配置层:两个 .cfg 加一个 .ini
30秒速赢:首次运行会在Hearthstone\BepInEx\config\自动生成HsSkins.cfg。把卡背改成想要的,进对局自动生效,不用任何快捷键。
关键字段含义:
HsMod.cfg(Hearthstone\BepInEx\config\):isPluginEnable(总开关)、timeGear(齿轮,默认 0,范围 -32~32)、webServerPort(Web 端口,默认 58744);HsSkins.cfg:skinCardBack(卡背)、skinCoin(幸运币)、匹配/酒馆英雄皮肤、终结特效等;doorstop_config.ini:dll_search_path_override必须指向BepInEx\unstripped_corlib;HsMatch.log:战旗对局统计,字段逗号分隔,路径可在设置里改。
💡组合技:对局中换皮= 改
HsSkins.cfg→ 按F4保存配置并模拟断线重连 → 英雄皮肤、终结特效、幸运币当场全部换新,不用退对局。
这层适合谁:喜欢精细调参的人,所有可调项都收敛在这三个文件里。
命令行与 Web 层:afk 参数与 58744 端口
30秒速赢:启动参数加afk=1,游戏直接进挂机模板——插件开、齿轮开、挂机配置套用,不用进游戏逐个点。
afk=0/1/2/3/4:从全关到正常挂机、反挂机模式,一行参数搞定;port=xxxx改 Web 端口,width/height强制分辨率,debug开调试日志;hsunitid按账号隔离独立配置目录,多号互不干扰;VerifyWebCredentialstoken 登录,配合client.config持久化后可完全跳过战网启动器;- Showinfo Web 服务:默认监听 58744 端口,浏览器开
http://localhost:58744看佣兵养成进度、开包历史;/shell执行命令需先在设置里启用,云服务器记得放行该端口。
💡组合技:绕过启动器=
client.config存 token +VerifyWebCredentials登录 + 关闭掉线机制。长时间挂机不掉线,token 过期时在client.config里换一段即可。
这层适合谁:跑服务器、多账号挂机、想脚本化启动流程的人。
深挖两个功能
时间加速:我把齿轮拉到 8
在设置面板把timeGear设成 8,卡包动画和结算界面嗖嗖过去,以前 40 秒的开包流程压到 3 秒。坑很具体:设到 32 时匹配面板的文字基本糊成残影,我实测 16 是阅读和速度的平衡点。进阶技巧:配合「快速对战」再跳过一段动画,战棋结算更省时间,但终结特效的屏蔽以加速档为准。
快速开包:一次空格开五包
开启「快速开包」后,在卡包界面按空格,5 包一次翻完。再打开「自动分解全额返尘卡」,翻到的重复卡直接返尘,省掉回卡收藏逐个点。坑:分解直接动卡包,我拿小号先试了一轮,确认它只碰全额返尘的重复卡才上主号。进阶:叠加 8 倍时间加速,一整轮开包连鼠标都不用摸。
恢复与调试
总原则:先删相关.cfg让它重新生成默认值,反馈问题时附上HsMod.cfg,开发者才能定位。
| 症状 | 30 秒自查 | 还不行就…… |
|---|---|---|
| 功能完全不生效 | 逐个核对 BepInEx x64、unstripped_corlib、plugins 下的 HsMod.dll | 日志里找 "Plugin HsMod is loaded" |
| 配置保存不了 | 检查是否启用了其他炉石插件 | 删BepInEx\config\HsMod.cfg重新配置 |
| 皮肤显示异常 | 检查HsSkins.cfg格式 | 删HsMod.cfg重新生成 |
| Web 页面打不开 | Showinfo 是否启用、58744 是否被防火墙拦 | 看日志确认服务是否启动 |
| 游戏更新后失灵 | Assembly-CSharp.dll等核心文件是否变化 | 按版本号规则判断是否更新插件 |
版本号规则:以3.0.0.0为例,第 1 位是炉石主版本(3 对应 26 版本),第 2 位是该主版本内游戏更新次数,第 3 位是插件新增功能次数,第 4 位是修 bug 的编译号。只要Assembly-CSharp.dll没变、插件还能跑,就不用跟着游戏更新走。大版本更新前备份HsMod.cfg、HsSkins.cfg、HsMatch.log三个文件,出问题一键回滚。另外两点提醒:国服客户端默认启用反作弊 SDK,插件会屏蔽相关检测但无法 100% 保证账号安全;项目遵循 AGPL-3.0,不收集任何用户信息。
下一步动作就一件:打开终端把「五分钟装好并跑起来」那三条命令跑一遍,或者直接把HsMod.dll丢进BepInEx\plugins启动游戏。觉得翻译不准,改HsMod/Languages/下对应 JSON 重新编译,是参与这个项目最轻的入口。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考