HsMod：免费开源的炉石传说增强插件，8 倍速开包、皮肤修改与 50+ 功能上手指南

HsMod：免费开源的炉石传说增强插件，8 倍速开包、皮肤修改与 50+ 功能上手指南

【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod

HsMod 是一款基于 BepInEx 5 框架的炉石传说免费开源增强插件，内置 50 多项可按需开启的能力：8 倍速动画、一键开包与自动分解、弹窗屏蔽、皮肤自定义、对手对战情报、内置 Web 数据面板。这篇文章按"装好 → 选开关 → 改配置 → 排障 → 参与"的顺序讲清楚每一步该做什么。

速查卡片：先记住这六件事

功能地图：按"想解决什么"找开关

面对五十多项功能，建议先对号入座，只开自己真正需要的：

Windows 安装：5 步 5 分钟装好炉石插件

1. 拿插件本体：从项目 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。

2. 解压运行框架：把BepInEx 5 的 x64 构建解压到炉石传说根目录。客户端自 2026 年 7 月起已是 64 位程序，别选错 32 位版本；BepInEx 6 仍是预览版，暂不适配，认准 5。

3. 补齐运行库：新建Hearthstone\BepInEx\unstripped_corlib\目录，把项目 HsMod/UnstrippedCorlib 下的所有 DLL 复制进去。

4. 指路：编辑doorstop_config.ini，把dll_search_path_override设为BepInEx\unstripped_corlib。

5. 放插件、启动：把HsMod.dll放入Hearthstone\BepInEx\plugins，正常启动游戏即可。

💡装前必读：炉石传说的安装路径不能包含中文或其他非拉丁字符，否则插件无法加载。动手之前先检查一下目录名，这是新手最常踩的坑。

macOS 与 Linux 安装：改脚本、配 token、免战网启动

两个平台的操作骨架和 Windows 一致，差别只在 DLL 来源和启动脚本。

macOS 四步走：

1. BepInEx 5（universal 版）解压到Hearthstone/；
2. 把 HsMod/UnstrippedCorlibUnix 的 DLL 全部复制到/Applications/Hearthstone/BepInEx/unstripped_corlib/（Mono 与 Unity 版本需和客户端一致）；
3. 编辑run_bepinex.sh三处：dll_search_path_override="BepInEx/unstripped_corlib"、executable_name="Hearthstone.app"、把ARCHPREFERENCE改为"x86_64"（客户端目前还没有 arm64 版本）；
4. 执行chmod u+x run_bepinex.sh，然后用./run_bepinex.sh启动。

Linux 流程：

1. 先用 hearthstone-linux 项目把炉石客户端装到 Linux 上（它通常会帮你把client.config配好）；
2. 解压 BepInEx（unix, v5）到炉石根目录，把UnstrippedCorlibUnix的 DLL 放进hearthstone/BepInEx/unstripped_corlib/；
3. 脚本中设置DOORSTOP_CORLIB_OVERRIDE_PATH="$BASEDIR/BepInEx/unstripped_corlib"、executable_name="Bin/Hearthstone.x86_64"；
4. 运行sed -i "s/\r/ /g" ./run_bepinex.sh修正 Windows 风格的换行符，再chmod u+x run_bepinex.sh启动。

登录 token 怎么拿：打开你所在区服（美/欧/台/韩/国服等）的战网登录页，登录后会跳转到一条含http://localhost:0/?ST=的链接，复制ST=之后、&accountId=之前的那一段，作为参数传给启动脚本（如./run_bepinex.sh TOKEN）。想一劳永逸，就在炉石根目录（与Hearthstone.exe同级）放一个client.config：

[Config] Version = 3 [Aurora] VerifyWebCredentials = "TOKEN" ClientCheck = 0 Env.Override = 1 Env = us.actual.battle.net

其中Env取 token 的前两个字母（国服用cn.actual.battlenet.com.cn）。配好之后可以完全绕开战网启动器；token 过期导致游戏打不开时，更新一下client.config即可。

提速场景：8 倍速、帧率显示与窗口自由

• 齿轮拉满：原版齿轮档位有限，HsMod 默认支持8 倍速，在HsMod.cfg里极限可配到32 倍，开包、结算、过场动画都快速通过；
• 帧率显示与锁定：界面实时显示 FPS，还能手动修改游戏最大帧率——低配机器把帧率锁在自己能稳住的数值，比"硬顶"更流畅；
• 解除窗口限制：去掉"窗口必须在前台"的焦点要求和窗口大小限制，切出去查攻略、回消息，游戏不会被暂停；
• 挂机用户不必进游戏改设置：启动时加命令行参数afk=1直接进挂机模板（启用插件+齿轮），afk=4进反挂机模式。

省心场景：开包、分解、领奖、弹窗一次配齐

日常最费时间的不是对战，而是机械操作，这部分正是炉石开包加速和自动化收益最大的地方：

• 快速开包：按空格键一次开5 包，可勾选"开包时自动分解全额返尘卡牌"，整个过程几乎不用碰鼠标；
• 一键分解：对已集齐的卡组一键自动分解返尘卡，需要给它绑定一个快捷键；
• 自动领奖：竞技场、对决、佣兵等模式结束后的奖励自动领取，奖励包也会顺手打开；
• 弹窗屏蔽：每类弹窗独立开关——无法匹配提示、削卡补丁通知、广告推销、天梯结算奖励、对局结束推广、成就奖励提示，碍眼的逐个关掉；
• 登录简化：用VerifyWebCredentials参数在命令行直接登录，配合client.config一次配置长期有效，还可以禁用掉线机制，长时间挂机不掉。

⚠️进阶提醒：自动分解、自动领奖会直接改动你的账号资源。建议先在普通号上开启观察，确认行为符合预期，再带到主力号上使用。

外观场景：炉石免费皮肤修改，对局中按 F4 即时生效

首次运行时，插件会在BepInEx\config\下自动生成HsSkins.cfg，这是炉石皮肤修改免费方案的入口，可改的内容包括：

• 匹配界面的英雄皮肤、酒馆内的英雄皮肤；
• 终结特效、匹配面板、酒馆面板、幸运币；
• 卡背修改（进游戏自动生效，无需额外操作）；
• 自动金卡、强制钻石卡，以及佣兵的随机皮肤、强制钻石皮肤。

对局中想临时换一套外观：按F4保存皮肤配置并模拟一次断线重连，不用退出对局就生效。注意F4是固定快捷键，它同时会转储一些游戏内信息（保存在Hearthstone\BepInEx\下）并重启 Web 服务；其余快捷键都可以自行绑定。

对战情报与表情管理：对手信息看个明白

• 显示对手完整战网昵称，不再只有半截名字，还可以在对局中直接加对方为好友；
• 天梯结算前展示对手的段位（传说前）；
• 标记对手的已知卡牌——需要你在对局中持续"喂"信息，它更像一本战术笔记本，而不是全知外挂；
• 点击对手头像获取其酒馆玩家昵称；
• 表情管理全家桶：对局开始自动屏蔽所有对手表情、设置表情频率上限、屏蔽"思考中"表情、无冷却发表情（最小间隔1.5 秒）、快捷键一键静音炉石。

进阶工具箱：Web 数据面板、模拟开包与开发者模式

• Web 数据面板（Showinfo）：插件内置的轻量 HTTP 服务，默认监听58744端口且一般绑定本机所有 IP。浏览器打开http://localhost:58744即可查看佣兵养成进度、开包历史等数据；在设置里打开开关后，还能访问/shell路径执行命令、调整配置（中文输出可能乱码）。跑在云服务器上的话，记得在防火墙和安全组放行 58744 端口。服务端实现见 HsMod/WebServer.cs；
• 开发者模式：一键进入炉石开发者模式，查看卡牌数据、理解机制实现；
• 模拟开包：随机或固定结果，卡包类型、数量、稀有度与质量都可自定义，测试手感、录制演示都合适；
• 设备伪装：模拟 iOS、Android 等设备领取专属卡背（可能需要先打一局匹配）；
• 冒险模式：用金币直接购买纳克萨玛斯、黑石山、探险者协会等冒险；卡拉赞支持强制开启，但无法体验序章；
• 静默对局：模拟断线/拔线（需绑定快捷键），观战好友时自动切换双方视角。

配置与版本：三个文件要记住，版本号决定要不要升级

最常打交道的是这三个文件：

游戏或插件大版本更新之前，把这三个文件备份一份，出问题直接回滚，不用重新调教几十个选项。

版本号是四段式，以3.0.0.0为例：

由此得出一个实用判断：炉石更新 ≠ 插件失效。只要插件还能正常运行，就不用急着去 Release 换新版本；只有核心文件发生变化时，才需要考虑升级。

排障速查表：出问题了先删 .cfg

任何异常的第一反应：删除对应的.cfg配置文件，重启游戏。插件会自动生成一份全新默认配置，多数问题到这一步就消失了。

反馈问题时附上你的HsMod.cfg，能帮开发者更快定位问题。

参与项目与账号安全须知

• 协议与定位：AGPL-3.0，面向学习与研究，插件本身不收集任何用户信息；
• 翻译：HsMod/Languages/ 目录下有简体中文、繁体中文、英语、日语、韩语等多份 JSON 翻译文件，觉得哪句译得不准，改完 JSON 重新编译就能参与贡献；
• 源码：每项功能对应 HsMod/Patches/ 下的一个补丁，例如 HsMod/Patches/PatchHearthstone.cs 处理主逻辑、HsMod/Patches/PatchFakePackOpening.cs 对应模拟开包，Web 服务见 HsMod/WebServer.cs，顺藤摸瓜就能看懂并动手改进；
• 迭代方向：游戏内一键更换英雄皮肤、Web 配置界面重构、macOS 适配完善、佣兵相关功能修复等都在路线上。

⚠️安全须知：中国大陆地区的炉石客户端默认启动反作弊 SDK。HsMod 会尽力屏蔽相关检测，但无法 100% 保证账号安全。知情、适量、量力而行，才是长期使用这款插件的正确姿势。

【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod