HsMod 完整指南:炉石传说 BepInEx 插件,8 倍速加速、空格连开 5 包、开关全默认关闭
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一个基于 BepInEx 的炉石传说插件:动画 8 倍速、空格连开 5 包、对手 MMR 显示、皮肤与 Web 面板等功能,全部开关默认关闭,游戏内按 Esc 打开 Mod Settings 按需勾选。
场景速查:先回答三个问题
- 哪个系统?Windows / macOS / Linux 都支持,Windows 主线最短,另两个平台要改启动脚本的几个点。
- 打算省多少事?只求提速和自动化,五步装完即可;想折腾 Web、皮肤和战报,跑通后再看「深度玩家型」。
- 要自己编译吗?最快是从 Releases 下载
HsMod.dll;想改代码的装 .NET SDK 8.x,一条命令出包。
五步装好:从零到跑通
前置条件:先查三样
| 项目 | 要求 |
|---|---|
| BepInEx | 5 系 x64(BepInEx 6 仍是预发布、未适配;2026-07-01 起客户端为 64 位) |
| 安装路径 | 不能含中文等非拉丁字符,三平台通用 |
| HsMod.dll | 从 Releases 下载,或装 .NET SDK 8.x 自行编译 |
Windows 主线五步
自行编译先跑三条命令,产物在HsMod/Release/目录:
git clone --depth 1 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore- 把 BepInEx x64 解压到炉石根目录。
- 建
BepInEx\unstripped_corlib\,把 HsMod/UnstrippedCorlib/ 下全部 DLL 拷进去。 - 编辑
doorstop_config.ini:BepInEx 5.4.23.2 及以后写dll_search_path_override = BepInEx\unstripped_corlib,更早版本写dllSearchPathOverride=BepInEx\unstripped_corlib(等号两侧无空格)。 HsMod.dll放进BepInEx\plugins\。- 启动游戏按
Esc,菜单出现Mod Settings即装好。
macOS:脚本改三处 + 首次 token
用HsMod/UnstrippedCorlibUinx的 DLL 拷入BepInEx/unstripped_corlib/。改run_bepinex.sh三处:executable_name="Hearthstone.app"、export ARCHPREFERENCE一行换成export ARCHPREFERENCE="x86_64"(客户端暂不支持 arm64)、chmod u+x。首次启动打开战网登录链接,截http://localhost:0/?ST=之后、&accountId=之前的串传给./run_bepinex.sh TOKEN;建好client.config存住 token 后,直接./run_bepinex.sh即可。
Linux:修脚本换行再启动
先用 hearthstone-linux 项目装好客户端(通常会自动建client.config)。解压 BepInEx unix 版,照上节拷UnstrippedCorlibUinx的 DLL;run_bepinex.sh里设DOORSTOP_CORLIB_OVERRIDE_PATH="$BASEDIR/BepInEx/unstripped_corlib"和executable_name="Bin/Hearthstone.x86_64",再sed -i "s/\r/ /g" ./run_bepinex.sh修换行,chmod u+x后启动。
游戏更新后要不要动插件
版本号四段各管一段:第一位跟炉石主版本,第二位记该主版本内更新次数(Assembly-CSharp.dll等核心文件真变了才加),第三位记功能新增,第四位是编译修复。判断标准只有一条:炉石更新 ≠ 插件失效。对比更新前后Assembly-CSharp.dll,没变且功能正常就继续用,变了再换新HsMod.dll,不必每次 Release 都跟着换。
按玩法挑组合
所有开关默认关闭,按需勾选,先挑 5 个以内。
挂机型:放托管跑
- 启动参数
afk=1—— 一键挂起模板:插件、齿轮同时打开且齿轮置零;afk=4是反挂机版。 - 齿轮快 8 倍速 —— 开包结算动画直接快进,上限可在设置里拉到 32 倍。
- 禁用掉线 —— 长时间无操作不掉线。
- 自动领奖 —— 竞技场、对决、佣兵结束自动开奖励包裹。
- 弹窗批量屏蔽 —— 匹配失败、削卡提示、广告、天梯结算一起拦。
省事型:手动玩,只求快
- 空格一次开 5 包 —— 可勾开包时自动分解全额返尘卡。
- 快速战斗 —— 跳一部分动画,比齿轮顺,开时自动屏蔽终结特效。
- 完整对手昵称 + 传说前天梯段位 —— 进场先摸底。
- 标记对手已知卡牌 —— 持续喂对手手牌信息,随身战术笔记。
- 屏蔽主播模式 —— 防误触 Ctrl+Shift+S 改掉玩家名。
深度玩家型:要折腾
- Showinfo —— 设置里启用后浏览器访问
http://localhost:58744,看佣兵养成进度、开包历史;云服务器要放行 58744。 - 皮肤系统 ——
HsSkins.cfg或设置里改对战 / 酒馆英雄、卡背、幸运币,按F4保存并模拟断线当场生效。 /shell命令页 —— 可执行命令、调配置,谨慎使用。
出问题了查这张表
| 症状 | 最可能原因 | 一行动作 |
|---|---|---|
| 装了没反应 | 路径含非拉丁字符,或 DLL 放错位置 | 换纯英文路径;确认HsMod.dll在BepInEx\plugins\、unstripped_corlib 完整 |
| 配置存不上 | 与别的 BepInEx 插件冲突 | 关掉其他插件只留 HsMod 再改一次 |
| 皮肤不生效 | 手改HsSkins.cfg漏了引号 | 删掉HsMod.cfg重新生成,进游戏按F4 |
| Web 页面打不开 | Showinfo 没启用或端口没放行 | 查设置开关;云服务器放行 58744 |
补丁不报错但不生效(插件冲突)。与别的修改Assembly-CSharp.dll的模组(佣兵类插件、MixMod 之类)同挂时,补丁偏移可能对不上,HsMod 不报错但功能失灵。隔离最快:禁用全部其他插件,单跑 HsMod 验证一遍。
游戏更新后集体失效。多数是核心文件变了没换 DLL。先确认Assembly-CSharp.dll是否变化,变了才升级插件;没变别盲目追新版本。
风险边界与大更新前备份
项目遵循 AGPL-3.0,仅供学习研究,不收集任何用户信息。风险说透:国服客户端默认启用反作弊 SDK,插件会尽力屏蔽相关检测,但无法 100% 保证账号安全,值不值得用自己掂量。
大更新前把这三处各拷一份,出问题秒回滚:
BepInEx\config\HsMod.cfgBepInEx\config\HsSkins.cfgBepInEx\HsMatch.log
想参与项目:加语言改 HsMod/Languages/ 里的 JSON 重新编译即可,各功能补丁实现都在 HsMod/Patches/ 下,顺着源码读就能改。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考