炉石插件 HsMod 实战指南：三步装好，最高 32 倍速

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

HsMod 是一款基于 BepInEx 框架的炉石传说增强插件，采用 Harmony 热补丁技术（不改游戏本体文件、只改运行时行为），集中解决日常流程慢、界面不可定制、局内信息不透明三类痛点。项目遵循 AGPL-3.0 协议，不收集任何用户数据，支持 Windows、macOS 和 Linux 三大平台，适合想给日常提速、换外观、查对手信息的玩家。先说清一项风险：国服炉石客户端默认启用反作弊 SDK，HsMod 会尝试屏蔽相关功能，但无法保证账号安全，项目定位是学习与研究用途，后果需使用者自行评估。

⚠️ 炉石 Mod 安装前路径与环境核对

动手之前按顺序过一遍，任何一项不满足都会导致插件加载失败。

1. 先查游戏安装路径。炉石客户端路径任一层级都不能含中文或其他非拉丁字符，这是最高频的坑，发现就先把整条路径改成纯拉丁字符。
2. 再查 BepInEx 版本与位数。必须用 5 系列的 x64 包：炉石客户端自 2026-07-01 起转为 64 位程序，而 BepInEx 6 仍在预发布阶段、尚未适配，不可使用。
3. 是否自己编译。自编译需安装 .NET SDK 8.x；直接拿 Release 版HsMod.dll则跳过此步。
4. 准备运行时 DLL。Windows 取项目HsMod/UnstrippedCorlib目录下的全部文件；macOS/Linux 则改用HsMod/UnstrippedCorlibUinx。

Windows 三步安装与首次启动

场景：按上面清单核对完毕后，在 Windows 上部署并让设置面板可用。

1. 拿插件。从发布版下载，或自行编译（产物在HsMod/Release/HsMod.dll）：

git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore

2. 部署 BepInEx。把 BepInEx x64 解压到炉石根目录Hearthstone\，再新建Hearthstone\BepInEx\unstripped_corlib\，将运行时 DLL 全部拷入。
3. 改配置并启动。在doorstop_config.ini中写入dll_search_path_override = BepInEx\unstripped_corlib（旧版 BepInEx 的键名是dllSearchPathOverride），把HsMod.dll放进Hearthstone\BepInEx\plugins，然后启动游戏。

预期效果：进游戏按Esc即可打开 Mod Settings 面板。绝大多数功能是默认关闭的，必须逐项手动开启，新手最容易卡在这里；若面板毫无反应，先回头核对路径是否含非拉丁字符、BepInEx 是否 x64。

macOS 与 Linux 跨平台部署对比

思路与 Windows 一致，差异集中在运行时库与启动脚本：两平台都使用 BepInEx 5 对应安装包，运行时库换成UnstrippedCorlibUinx（要求 Mono 与 Unity 版本和炉石匹配）。

• macOS：解压 macos universal 包到炉石目录，在run_bepinex.sh中设executable_name="Hearthstone.app"，并把ARCHPREFERENCE改为x86_64——炉石目前没有 arm64 原生支持。
• Linux：先用社区方案装好炉石 Linux 客户端（一般会自动配好client.config），再解压 BepInEx unix 版 v5 包，设好DOORSTOP_CORLIB_OVERRIDE_PATH与executable_name，最后运行./run_bepinex.sh。

⚙️ 炉石加速插件日常提速：档位、快速模式与挂机

场景：日常任务与刷金币时嫌节奏拖沓，希望把对局压短。

• 齿轮加速：设置中开启后，用方向键切换档位——上/下键加减速，左/右键回默认/最大。默认上限 8 倍速，想再快就编辑HsMod.cfg的timeGear项（允许范围 -32 到 32），把上限拉到 32 倍：动画保留，整体节奏变快，适合边打日常边刷金币。
• 快速模式（Fast battle）：更干脆的玩法，直接跳过大部分动画，放终结技时连特效一并屏蔽；佣兵 PvE 的酒馆同样可用，仅最后的死亡结算偶尔卡顿。
• 挂机参数：配合"禁用掉线检测"可长时间无操作而不被踢出；懒人启动时直接带命令行参数afk=1，插件会套上挂机模板（齿轮置零、AwayFromKeyboard 配置），设置面板都不用进。刷金币建议把加速与禁用掉线检测一次配齐。

🎨 皮肤与卡背定制：导出、映射到生效

所有外观替换集中在Hearthstone\BepInEx\config\HsSkins.cfg（首次运行自动生成），可替换对象涵盖匹配/酒馆英雄皮肤、终结特效、匹配与酒馆面板、幸运金币、卡背、表情边框等。流程分三步：

1. 导出：按F4，插件把当前全部皮肤信息（含 DbId）导出到 BepInEx 目录，据此查原始皮肤 ID。
2. 映射：在HsSkins.cfg中按原始ID:替换ID书写，例如玛法里奥换成大导师玛法里奥；写成a:b,c,d的多值形式则为随机皮肤。
3. 生效：改完再按一次 F4 更新配置；若正处于对局中，还需触发一次模拟断线才生效。卡背替换则配置后自动生效，无需额外操作。换了 ID 没反应时，先核对映射值，再删除HsMod.cfg重新配置。

Web 面板与辅助能力一览（默认端口 58744）

这一节收拢零散功能。插件内置 Web 服务，默认端口58744：/config是网页版配置管理，可作游戏内面板的备用入口；/shell是 WebShell，默认关闭，需在设置中显式开启（中文显示可能乱码）；Showinfo 页面可查佣兵养成进度与开包历史，佣兵玩家常用。按 F4 时会顺带重启该 Web 服务。端口默认监听所有本地 IP——炉石若跑在云服务器上，务必检查防火墙与安全组，避免对外暴露。

炉石插件版本号读法：以 12.1.0.1 为例

以12.1.0.1拆解：第 1 位对应炉石主版本号；第 2 位是该版本内炉石更新且改动了Assembly-CSharp.dll等文件的次数，未改动到这些文件的更新不计入；第 3 位在该炉石版本下新增功能时 +1，第 2 位变化时清零；第 4 位是编译版本，主要跟随第 3 位的 bug 修复。实用结论：炉石更新后插件不一定坏，功能都正常就没有必要急着换新版。

炉石插件排错对照表

遇到异常时按这张表对号入座，而不是逐节翻正文。

日常排查另有两个依据：逗号分隔的统计日志BepInEx\HsMatch.log，以及 BepInEx 自身的运行日志。

常见疑问 FAQ

哪个快捷键是写死的？只有F4：导出局内信息（存到 BepInEx 目录）、更新皮肤配置、重启 Web 服务三件事都挂在它上面。其余快捷键——加速档切换、模拟断线、投降、静音、开包、酒馆五件套、表情等——全部可在设置面板重绑。

不经过战网客户端能启动吗？可以。在炉石根目录放一个client.config，在[Aurora]段写入 Token：

[Aurora] VerifyWebCredentials = "TOKEN"

Token 取自对应地区战网登录链接跳转地址中?ST=之后、&accountId=之前的部分；国服Env值为cn.actual.battlenet.com.cn，其他地区一般取 Token 前两位对应。配好后运行Hearthstone.exe VerifyWebCredentials即可启动，Token 过期后更新该文件即可。

更多安装细节与全部设置项见 ReadMe.md，各功能的补丁实现分布在 HsMod/Patches/ 目录下，可按文件名定位到具体逻辑。

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