HsMod 完整指南：32 倍变速齿轮、批量开包与对局内换皮肤
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是基于 BepInEx（Unity 游戏模组加载框架）的炉石传说开源增强插件，提供 32 倍变速齿轮、空格批量开包、对手信息显示与对局内换皮肤等 50 多项功能，免费且遵循 AGPL-3.0 开源协议，支持 Windows、macOS、Linux，适合想加速日常、自定义对局外观的玩家。
先搞清 HsMod：它做什么，又坚决不做什么
HsMod 的本质是一个注入炉石客户端的 .dll，通过 BepInEx 5（一款把模组以动态库形式挂进 Unity 游戏的框架）加载后生效。项目按 AGPL-3.0 协议开源，当前版本 12.1.0.1，四段式含义依次是：炉石主版本 / 该主版本内炉石更新次数 / HsMod 在该版本上的功能递增 / 编译修复号——炉石更新后插件还能用，就不必急着从 Releases 换 DLL。
动手前先划清三条边界：
- 它不做什么：不收集任何用户信息、不上传任何东西，全部配置只落在本地
Hearthstone\BepInEx\config\下的 .cfg 文件里 - 账号安全边界：国服客户端默认启动反作弊 SDK，「反作弊拦截」只是尝试屏蔽，不保证账号安全；金币购买冒险（buyAdventure）同属灰色功能。重要账号建议另备一个纯净客户端
- 网络服务边界：内置 Web 服务默认在 58744 端口监听本机所有 IP，云服务器上用必须配好防火墙和安全组；WebShell（/shell 路径的命令行入口）默认关闭、需手动开启，用不上就保持关闭
🎯 解决四类真实痛点：等待、点击、信息、外观
竞技场坐等十几分钟
竞技场、佣兵的动画只能一遍遍看完，一轮日常拖上十几分钟是常态。开启变速齿轮后按 8 倍速跑，等待时间直接除以 8；上限 32 倍，同一段内容被压缩到 1/32。
几十包奖包一点一点点
手里几十包奖包，竞技场、佣兵结算各留一堆宝箱，逐包点开。开包加速后按空格一次开 5 包并直接跳到结果页；再叠上自动开盒，竞技场、佣兵的结算宝箱替你打开，不再卡在结算画面等点击。
匹配界面看不到对手底细
默认匹配界面只有截断的昵称，对手什么水平全凭猜。打开显示全名能看到对手战网完整昵称，打开天梯等级显示能看到传说前的具体段位；卡牌追踪还会标记对手已用出的卡（属推测性质，有小概率认错，别当绝对信息）。
英雄皮肤只有默认款
炉石皮肤全部锁在系统默认。HsMod 可改匹配英雄皮肤（skinHero）、酒馆英雄皮肤、卡背（skinCardBack）、幸运金币（skinCoin）、终场特效等，编辑 HsSkins.cfg 后在对局中按 F4 保存生效。
快速上手：三步把 HsMod 装进炉石
前置条件 3 条：
- 最新版炉石客户端，安装路径不含中文等非拉丁字符
- BepInEx 5 的 x64 包（炉石自 2026-07-01 起为 64 位程序，BepInEx 6 暂不适配）
- 一份 HsMod.dll：从项目 Releases 下载，或从源码编译（需 .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安装三步（Windows）：
- 把 BepInEx x64 解压到炉石根目录
Hearthstone\ - 把仓库 HsMod/UnstrippedCorlib 里全部 DLL 拷到
Hearthstone\BepInEx\unstripped_corlib\，并在doorstop_config.ini写入dll_search_path_override = BepInEx\unstripped_corlib - 把 HsMod.dll 放进
Hearthstone\BepInEx\plugins，启动游戏，按 Esc 进「Mod Settings」确认插件已加载
macOS 与 Linux 步骤相同，运行时 DLL 改用 HsMod/UnstrippedCorlibUnix 目录，最后用./run_bepinex.sh启动。起不来时依次查两件事：路径有没有非拉丁字符、doorstop_config.ini 那行有没有写对。
⚙️ 功能档位表：哪些直接开、哪些按需、哪些谨慎
几乎所有功能默认关闭，需在「Mod Settings」里手动开启。表内配置键均为 HsMod/PluginConfig.cs 中的真实项。
| 档位 | 功能 | 一句话效果 |
|---|---|---|
| 建议默认开 | 变速齿轮（isTimeGearEnable / timeGear） | 游戏流程提速，日常 8 倍，最高 32 倍 |
| 建议默认开 | 自动开盒（isAutoOpenBoxesRewardEnable） | 自动打开竞技场、对决、佣兵结算宝箱 |
| 建议默认开 | 显示全名（isFullnameShow） | 显示对手战网完整昵称 |
| 建议默认开 | 天梯等级显示（isOpponentRankInGameShow） | 传说前显示对手天梯段位 |
| 建议默认开 | 弹窗屏蔽（isAlertPopupShow） | 过滤「无法匹配」等干扰弹窗 |
| 按需开 | 快速战斗（isQuickModeEnable） | 跳过部分动画，酒馆与佣兵 PvE 也能用 |
| 按需开 | 开包加速（isQuickPackOpeningEnable） | 空格一次开 5 包，直接展示结果 |
| 按需开 | 卡牌追踪（isCardTrackerEnable） | 推测并标记对手已用卡，可能识别错误 |
| 按需开 | 对手表情限制（receiveEnemyEmoteLimit） | 整局屏蔽对手表情，思考表情可单独限制 |
| 按需开 | Showinfo 网页（webServerPort） | 本机 58744 端口看佣兵进度、开包历史 |
| 按需开 | 皮肤切换（skinHero / skinCardBack） | 改英雄皮肤、卡背、终场特效，F4 生效 |
| 谨慎开 | WebShell（isWebshellEnable） | /shell 路径命令行入口，默认关闭 |
| 谨慎开 | 模拟开包（isFakeOpenEnable） | 随机或固定结果模拟开包，数量、稀有度可自定义 |
| 谨慎开 | 自动举报（isAutoReportEnable） | 自动举报对手，可同时生成对局日志 |
| 谨慎开 | 金币购买冒险（buyAdventure） | 金币购买纳克萨玛斯、黑石山等冒险 |
| 谨慎开 | 反作弊拦截 | 尝试屏蔽国服默认启动的反作弊 SDK，不保证账号安全 |
深度拆解两个功能：变速齿轮配置方法与开包加速
变速齿轮怎么配
它做什么：把游戏内动画、结算、过场的播放速率整体调快。timeGear 取值范围 -32 到 32，1 和 0 是原速，正数加速、负数变慢，日常用 8 倍以内即可保留完整动画。
最小配置写在Hearthstone\BepInEx\config\HsMod.cfg（也可在「Mod Settings」里改）：
isTimeGearEnable = true timeGear = 8.0体验变化：日常任务与佣兵刷本的等待时间除以 8；对局中默认按 ↑ 加速、↓ 减速、← 回默认、→ 拉满，全程不用离开键盘。
开包加速 + 自动开盒
机制：把「点一下开一包」改成「按空格开 5 包并直接跳到结果页」，开出的卡直接进收藏，还可顺带自动分解完全可退还的卡（isAutoRefundCardDisenchantEnable）；自动开盒则在你打完竞技场、佣兵后替你打开结算宝箱。
配置就是上表的 isQuickPackOpeningEnable 与 isAutoOpenBoxesRewardEnable 两项，默认均关闭。
体验变化：清一摞奖包从几十次点击变成几轮空格；竞技场连打时结算画面不再卡着等你点，下一场排队时间缩短。
一天的真实操作：从启动到换皮肤
- 启动炉石，BepInEx 自动注入，HsMod 加载完成
- 按 Esc 进「Mod Settings」，确认「建议默认开」的 5 项已启用
- 打竞技场或佣兵前确认变速齿轮已开，局内用 ↑ / ↓ 调倍速
- 回收藏页清奖包：按住空格，每轮开 5 包，可开自动分解
- 一局结束的结算宝箱自动打开，无需手动点
- 需要换皮肤时编辑 HsSkins.cfg（首次运行自动生成），对局中按 F4 保存并更新
- 浏览器打开 http://localhost:58744 查看开包历史与佣兵养成进度（需先启用对应功能）
出问题时看这里：排障表与最小重置操作
| 症状 | 原因 | 解决 |
|---|---|---|
| 游戏起不来、没有 BepInEx 日志 | 安装路径含中文等非拉丁字符 | 把炉石挪到纯英文路径再启动 |
| 某项功能不生效 | 其他插件改过 Assembly-CSharp.dll 致 IL 偏移错位，或同一方法被两个插件重复打补丁 | 逐个禁用其他 BepInEx 插件排查 |
| 设置改了保存不上 | 有其他炉石插件同时启用 | 关掉其他插件再保存 |
| 配置后功能行为怪异 | 旧配置文件残留 | 删除BepInEx\config\里对应 .cfg 后重启重配 |
| 皮肤显示错乱 | HsSkins.cfg 内容不对 | 检查 HsSkins.cfg，必要时删 HsMod.cfg 重配 |
最小重置操作（Windows）：
del Hearthstone\BepInEx\config\HsMod.cfg
然后重启游戏重配。仍无效时，把 HsMod.cfg 和BepInEx\HsMatch.log日志附在项目 Issues 里。
结尾：5 条立即可执行的清单
- 首次只开 3 项：变速齿轮、自动开盒、显示全名，完整打一轮确认无异常再加
- 每次改完配置，回
BepInEx\config\确认 .cfg 里确实写入了新值 - 启用「谨慎开」功能前，先把
BepInEx\config整个文件夹复制一份备份 - 任何功能行为怪异，第一步删对应 .cfg 重配，而不是怀疑插件本身
- 炉石每次更新后先启动试一局，确认补丁失效再考虑更新 HsMod.dll
HsMod 遵循 AGPL-3.0 开源协议发布，免费且代码可审计，具体补丁实现在 HsMod/Patches 目录。请合理使用权能，遵守游戏规则，不要影响其他玩家的对局体验。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
 与 本地大模型对接：把 endpoint 改到 TaoToken 的完整配置)
