HsMod 炉石插件完整教程：60+ 项功能从安装到设置，三级风险边界一次讲透
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一款基于 BepInEx 的炉石传说插件（炉石插件），内置 60+ 项功能，覆盖本地皮肤自定义、对局加速、酒馆战棋 MMR 显示与挂机自动化，AGPL-3.0 开源、不收集任何玩家信息。本文按"先划红线、再装、再选功能"的决策顺序，带你从零把它跑起来，并给出分级使用建议。
一、装之前先搞清楚：HsMod 是怎么工作的
可以把炉石客户端想象成一台出厂封口的乐器：内部线路焊死，普通用户碰不到。BepInEx 是插在这台乐器上的一个"效果踏板机架"——它提供标准插槽，游戏运行时才通电；HsMod 则是插上去的一个踏板（一个编译好的HsMod.dll），插上改变音色，拔掉一切复原，游戏本体文件一个字节都不动。
这个模型决定了三件事：
- 生效时机：补丁只在游戏进程内临时改写行为，关闭游戏即消失；
- 回滚成本极低：删掉插件 DLL 就回到出厂状态（见第八节 FAQ）；
- 依赖链严格：它挂钩的是
Assembly-CSharp.dll这类核心文件，所以游戏更新、路径环境、其他插件都可能让它"哑火"。
两个必须说透的前提
- 开源 ≠ 安全。项目遵循 AGPL-3.0 协议，代码公开、不收集任何玩家信息，但"代码可见"和"账号绝对安全"是两码事。
- 反作弊是绕不开的话题。大陆客户端默认启动暴雪内置的反作弊 SDK，HsMod 会尝试屏蔽相关检测（见 HsMod/Patches/ 中的 PatchAntiCheat），但官方文档 ReadMe.md 明确标注：无法保证账号安全。凡涉及真实奖励领取、与服务器交互的选项，请先看下面的风险分级。
二、风险分级总览：A / B / C 三档，先对号再开功能
原文作者喜欢按人群分功能，这里换个思路：先按"会不会触碰服务器"分档，你再回头挑自己要的。
| 档位 | 判定标准 | 代表功能 | 建议 |
|---|---|---|---|
| A 档·纯本地 | 只改本机显示，无服务端交互 | 卡牌镀金/钻石特效、英雄/卡背/幸运币皮肤、酒馆外观本地解锁、对手 MMR 显示、对局统计、帧率显示 | 放心开，是性价比最高的部分 |
| B 档·本地行为 | 改变本机操作节奏或模拟本地状态 | 快速战斗、变速齿轮、自动开包、无冷却表情、模拟断线、模拟开包 | 小账号或接受已知 bug 再用；首次启用建议前台盯着 |
| C 档·服务端交互 | 功能结果会写进账号数据 | 零元购、金币购买冒险（含卡拉赞修复）、设备伪装领卡背 | 源码注释明确存在封号概率，除非是小号，直接避开 |
另外两个需要单独留意的点：
- 卡牌揭示（直接翻出对手手牌）可能触发强制断线重连，归入 B 档偏保守侧使用；
- 变速默认最高 8 倍，配置上限 32 倍——后者只适合测试环境，太快画面容易撕裂。
三、安装教程：Windows 五步装好（约 15 分钟）
前置条件：BepInEx 选5.x 的 x64 版。BepInEx 6 仍在预览阶段，官方尚未适配；游戏自 2026 年 7 月起已是 64 位程序，32 位版必然失败。安装路径不能含中文等非拉丁字符。
第 1 步：铺机架。把 BepInEx 5.x x64 压缩包整个解压到炉石根目录Hearthstone\。
第 2 步：补齐运行库。新建Hearthstone\BepInEx\unstripped_corlib\，将仓库中 HsMod/UnstrippedCorlib/ 下的全部 DLL 复制进去。
第 3 步：改搜索路径。编辑根目录的doorstop_config.ini，把搜索路径指向工具库：
- BepInEx ≥ 5.4.23.2：
dll_search_path_override = BepInEx\unstripped_corlib - 更早版本写法为
dllSearchPathOverride=BepInEx\unstripped_corlib
第 4 步：插踏板。把HsMod.dll放入Hearthstone\BepInEx\plugins。
第 5 步：启动游戏。直接双击Hearthstone.exe即可。
从源码自行编译
如果不想用 Release 产物：
git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore需要 .NET SDK 8.x，产物位于./HsMod/Release/HsMod.dll。仓库自带的 HsMod/install.bat 会在编译后自动把 DLL 拷进默认炉石安装目录（前提是该目录已装好 BepInEx）。
macOS / Linux 用户走 unix 分支
流程一致，差别在运行库和启动脚本：把 HsMod/UnstrippedCorlibUinx/ 里的 DLL 拷入BepInEx/unstripped_corlib/，然后在run_bepinex.sh中配置dll_search_path_override（Linux 为DOORSTOP_CORLIB_OVERRIDE_PATH）与executable_name，并给脚本加执行权限。Linux 上通常还要准备client.config（见 FAQ Q3）。详细差异见 ReadMe.md 的 Installation 部分。
四、插件到底生效了没有：两个验证点
- 看主菜单：进游戏按 Esc 打开主菜单，出现Mod Settings按钮即生效；
- 看日志：打开
BepInEx\LogOutput.log，出现 HsMod 加载行且无红色报错即通过。
一个新手最容易踩的坑：绝大多数功能默认是关闭的。菜单里看不到任何变化 ≠ 没生效，进设置里手动打开开关再说。
五、三个配置入口，按你的习惯选一个
- 游戏内菜单（推荐）：Esc → Mod Settings，带分类、搜索框和快捷键捕获，日常够用；
- 网页界面：插件自带 Web 服务，默认监听58744端口，浏览器打开即可切换语言、实时保存；
/config路径下的页面与游戏内菜单同源，批量调参更快；页面模板存放在 HsMod/WebResources/； - 配置文件：
Hearthstone\BepInEx\config\下的HsMod.cfg（主配置）与HsSkins.cfg（皮肤映射，首次运行自动生成），适合喜欢精调的人。
快捷键规则：F4是固定键，负责刷新皮肤配置、重启 Web 服务并保存设置，不可重绑；其余全部可在设置里改绑。比如默认表情快捷键是数字键 1–6，"无冷却表情"的最小间隔为 1.5 秒。
六、功能清单：按四个模块过一遍
6.1 外观模块（A 档）：把界面换成自己喜欢的样子
- 普通卡牌自动显示为金色或钻石特效，纯本地换装；
- 皮肤可替换范围包括：匹配/酒馆英雄皮肤、卡背、幸运币、对战面板、酒馆面板、终结特效，宠物皮肤也可换；
- 皮肤映射写在
HsSkins.cfg，格式为原皮肤ID:替换皮肤ID，冒号后写a:b,c,d可实现"随机换到其中几个"； - 酒馆外观本地全部显示为已解锁，只看脸不花钱。
进阶技巧：对局中途想换皮肤，走"模拟断线"强刷流程——先关闭"报错退出"、允许弹窗出现，按快捷键模拟拔线，再按F4刷新皮肤配置即可热更新。
6.2 对局节奏模块（A/B 档）：战棋天梯的体感优化
- 对手 MMR 显示：排行榜在每位玩家名字下方直接标出隐藏匹配分，开局先摸清深浅（单排/双排均可，局开始时后台加载）；
- 对局统计：每把排位自动记录排名、分差、英雄到
BepInEx\HsMatch.log（逗号分隔），界面提供今日/7 天/本月/全部的趋势图，支持单排/双排筛选； - 商店快捷键（仅购物阶段生效，全部可重绑）：
R刷新、F冻结、U升酒馆、H放英雄技能、T查看队友棋盘（双排）; - 快速战斗：跳过部分动画，酒馆与佣兵 PvE 局更顺（佣兵的最终死亡结算可能略卡）;
- 变速齿轮：最高 8 倍速，上限可配到 32 倍，方向键上下加减、左归位、右拉满。
经验值：日常刷任务 4 倍足够稳，8 倍是实战极限。
6.3 挂机模块（B 档为主）：人不在电脑前的自动化
- AFK 模板：一键套用挂机预设——自动领竞技场/佣兵奖励、自动开宝箱、屏蔽弹窗一次配齐，也可用启动参数
afk直接指定模式； - 自动领奖：佣兵、冒险结算的奖励包自动收下；
- 快开卡包：按空格每次连开 5 包直接出结果，并可勾选自动分解"全额返尘"的卡。该功能有已知 bug，建议首次启用时在前台确认结果；
- 定时退出：设定运行时长，到点自动关游戏（对局中会等结算后再退）；
- 一键退坑开关：设置里本名叫"毁灭吧，赶紧的"，按下立刻放弃当前对局收场，用途自己体会。
组合技：定时退出 + 免战网启动（FAQ Q3），就是一条"下班前挂上、刷完自己走人"的全自动流程。
6.4 折腾模块（A 档 + 个别 B/C 档）：直接跟游戏本体打交道
- 模拟开包：自定义卡包类型、数量、稀有度、品质，想看全金包长什么样随便配；
- 设备模拟：伪装成 iOS/安卓设备领取对应平台的卡背奖励，可能需打一把匹配局（⚠️ 涉及真实奖励，先确认自己区服的情况）；
- Web 信息面板：58744 端口除设置页外，还能查看佣兵进度、开包记录等数据；另有
/shell页面（需在设置中启用）； - 开发者模式：解锁游戏隐藏的开发者选项；
- 其余零碎体验项：显示真实收藏卡数（9+ 显示实际数字）、一键清除
new!标记、屏蔽升级/结算/任务奖励弹窗、对手完整战网昵称显示、0-0 弃局等，都归在这组里。
七、游戏更新之后：什么时候必须换插件版本
HsMod 采用四位版本号，以3.0.0.0为例：
- 第一位：对应炉石大版本（如 3 代表 26 版本）；
- 第二位：该大版本内炉石更新次数——但只有更新真的改动了
Assembly-CSharp.dll这类关键文件才会递增； - 第三位：该炉石版本下 HsMod 新增功能的计数，第二位变化时归零；
- 第四位：编译版本，主要跟 bug 修复。
结论很实用：炉石更新 ≠ 插件必坏。先正常进游戏试一把，功能还在就继续用，不必追着 Release 换。
八、排错速查：六个常见症状对症下药
| 症状 | 最可能原因 | 解法 |
|---|---|---|
| 装完游戏打不开 | 环境链断裂 | 依次核查：BepInEx 是否在根目录 →unstripped_corlib是否齐全 →doorstop_config.ini是否改对 → 路径是否含中文 → 插件与 BepInEx 版本是否匹配；答案基本都在LogOutput.log |
| 皮肤显示错乱 | 映射格式写错 | 检查HsSkins.cfg；仍不对就删掉HsMod.cfg重新配置 |
| 设置存不上 | 与其他炉石插件冲突 | 逐个禁用其他插件，定位谁和谁抢同一处补丁 |
| 游戏更新后功能失效 | 版本号第一位不匹配 | 对照第七节判断是否真要换版本 |
| 补丁整体不生效 | 有人动过Assembly-CSharp.dll导致 IL 偏移错位，或多个 BepInEx 插件重复修补同一方法 | 移除对核心 DLL 的第三方修改；避免双插件叠打 |
| 想重置回出厂 | 配置残留 | 删掉BepInEx\config\下对应的.cfg重新配置 |
九、新手常见问题
Q1：怎样在安全底线内使用？A：只开 A 档（皮肤、镀金、MMR、统计）。B 档（自动开包等）用小号或接受 bug 风险再开；C 档（零元购、冒险购买、卡拉赞修复）源码注释已明确存在封号概率，直接绕开。卡牌揭示可能触发强制断线重连，也按谨慎项对待。记住：不收集信息 ≠ 承诺绝对安全。
Q2：游戏大更新后插件要跟着换吗？A：不一定。按第七节的版本号规则判断，能正常进游戏、功能正常就继续用。
Q3：可以不开战网客户端直接启动吗？A：可以。在Hearthstone.exe旁放一个client.config（token 从战网登录 URL 的ST=参数中截取），之后直接执行./Hearthstone.exe VerifyWebCredentials即可绕过战网启动；token 过期导致打不开时，更新client.config里的 token 即可。这条对挂机路线尤其顺手。
Q4：出问题怎么回滚？A：HsMod 不改游戏本体——删掉BepInEx\plugins里的HsMod.dll即恢复原样；想彻底回滚，把整个Hearthstone\BepInEx文件夹删掉即可。只是设置乱了的话，删对应.cfg重新配置就行，不必动安装。
十、收尾：一份可执行的建议开关清单
把选择权还给你，但可以给出一个稳妥的默认姿态：
- 建议开：MMR 显示、对局统计、卡牌镀金、皮肤映射、商店快捷键、屏蔽奖励弹窗；
- 按场景开：变速齿轮（刷任务时 4 倍）、快开包（盯屏用）、模拟断线（配合换皮肤）；
- 坚决不碰：C 档的服务端交互功能——除非你明确知道自己在用小号。
60+ 项功能只是工具箱：开哪些、关哪些，取决于你的主玩模式。挑顺手的开，红线别碰，炉石才能一直好玩。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
