当前位置：首页 > news >正文

HsMod炉石插件快速上手指南：三步安装，讲透加速、皮肤与Web面板

news 2026/8/22 16:48:17

HsMod炉石插件快速上手指南：三步安装，讲透加速、皮肤与Web面板

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

HsMod 是一个基于 BepInEx 框架开发的炉石传说免费开源增强插件（AGPL-3.0 协议），主要解决三类问题：动画和日常流程太慢、界面元素无法自定义、局内信息不够透明。它通过 Harmony 热补丁的方式修改运行时行为，不动游戏核心文件，支持 Windows、macOS 和 Linux。下面按"先装好、再会用、最后会排错"的顺序来讲。

三步装好 Windows 版

安装前有两个硬性条件：必须用 BepInEx 5 的 x64 包（炉石客户端自 2026 年 7 月 1 日起转为 64 位程序，BepInEx 6 仍在预发布阶段、尚未适配）；游戏安装路径不能含中文或其他非拉丁字符，否则插件加载不了。

步骤本身只有三件事：

拿到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（源码目录中的install.bat可以把它自动拷进已配好 BepInEx 的默认炉石目录）。

部署 BepInEx 和运行时库。把 BepInEx x64 解压到炉石根目录Hearthstone\，再把项目里HsMod/UnstrippedCorlib目录下的全部 DLL 复制到Hearthstone\BepInEx\unstripped_corlib\（新建该目录）。
改一处配置、放一个文件。在doorstop_config.ini中设置dll_search_path_override = BepInEx\unstripped_corlib（旧版 BepInEx 的键名是dllSearchPathOverride），然后把HsMod.dll放进Hearthstone\BepInEx\plugins，启动游戏即可。

进入游戏后按Esc打开"Mod Settings"面板。注意绝大多数功能默认关闭，需要在设置里逐项打开，这是新手最容易困惑的一点。

齿轮加速：8 倍速到 32 倍速

这是日常效率提升最明显的一块。插件提供两档思路：

齿轮模式：默认上限 8 倍速，配置文件里最高可调到 32 倍，动画仍然保留，只是整体节奏加快，适合边打日常边挂机刷金币、成就。
快速模式（Fast battle）：直接跳过大部分动画，比齿轮更"丝滑"，打终结技时还会屏蔽特效；在佣兵 PvE 的酒馆里也能用，但最后的死亡结算偶尔会卡一下。

配合"禁用掉线检测"（disable dropouts）后，可以长时间无操作不触发挂机踢出；启动时直接带命令行参数afk=1，插件会自动套用挂机配置模板（置零齿轮、套用 AwayFromKeyboard 模板），连设置都不用进。

皮肤与卡背：一个 HsSkins.cfg 管所有外观

所有外观替换集中在一个文件里：Hearthstone\BepInEx\config\HsSkins.cfg，首次运行时自动生成。支持的替换对象包括匹配英雄皮肤、酒馆英雄皮肤、终结特效、匹配面板、酒馆面板、幸运金币、卡背、表情边框等。

使用流程：

按F4，插件会在 BepInEx 目录下导出当前全部皮肤信息（含 DbId），方便你查"原始皮肤 ID 是多少"。
在HsSkins.cfg里按原始皮肤ID:替换皮肤ID的格式写映射，例如把玛法里奥换成大导师玛法里奥；写成a:b,c,d这种多值形式则是随机皮肤。
改完再按F4更新配置；如果此时正在对局中，还需要触发一次"模拟断线"让新皮肤生效。

卡背的替换相对省事，配置后自动在对局中生效，不需要额外操作。

内置 Web 面板：端口 58744 上能看什么

插件自带一个 Web 服务，默认端口58744，启动后浏览器访问本机该端口即可使用：

/config：网页版配置管理，游戏内设置面板不好用时可当备用入口；
/shell：WebShell，默认关闭，需要在设置中显式开启（中文显示可能乱码）；
Showinfo 页面：查看佣兵养成进度、开包历史记录等，佣兵玩家会常用到。

两点提醒：F4 的一个附加作用就是重启这个 Web 服务；该端口默认监听所有本地 IP，如果你把炉石跑在云服务器上，记得检查防火墙和安全组，别把这个端口暴露出去。

其他常用小功能，一句话带过

剩下的功能按类别各挑最实用的说：

开包：空格键一次开 5 包，可选"开包时自动分解可全额返还的卡"，也有一键分解整副可退牌组的快捷键。
信息透明：显示对手完整战网昵称、传奇之前的天梯等级、对手已知卡牌标记；酒馆战棋的排行榜覆盖层会在每个玩家名字下显示对方 MMR（双人模式匹配开始时后台加载）。
表情：自动屏蔽对手表情、屏蔽思考表情、屏蔽布伯语音；自己发表情无冷却（最小间隔 1.5 秒），六种常用表情各有快捷键。
自动与清理：自动领取竞技场、对战、佣兵等奖励（结束时打开奖励包）、自动举报对手并可自动生成交互日志、一键清除收藏里的new!标记、收藏夹卡牌数量显示真实数字（不再显示 9+）。
酒馆战棋：刷新、锁刷新、酒馆升级、英雄技能、查看队友棋盘五个操作都绑定了可重绑的快捷键，只在购物阶段生效；每局天梯的排名、MMR 变化和英雄会记录到 CSV，并提供今日/7 天/本月/全部的图表视图。
其他：解除窗口缩放和焦点限制、屏蔽各类弹窗（匹配失败提示、推广、天梯结算奖励等）、右键卡牌显示 DbId、静音快捷键。

版本号怎么读

HsMod 采用四段式版本号，以12.1.0.1为例：

段	含义
第 1 位	对应的炉石主版本号
第 2 位	该版本内炉石更新且改动了如`Assembly-CSharp.dll`之类文件的次数
第 3 位	针对该炉石版本新增功能时 +1，第 2 位变化时清零
第 4 位	编译版本，主要跟随第 3 位的 bug 修复

一个实用结论：炉石更新后插件不一定坏。如果更新后功能都正常，就没有必要急着换新版插件。

排错清单：出问题时按顺序查

路径含中文：检查整个游戏安装路径，任何一层目录含非拉丁字符都会导致问题，这是最高频的坑。
BepInEx 版本不对：确认是 BepInEx 5 且为 x64（或 macOS/Linux 的对应包）。
和其他插件冲突：凡是基于Assembly-CSharp.dll做修改的 mod 会让 IL 偏移错位、补丁失效；其他 BepInEx 插件（如佣兵类、MixMod 类）对同一方法二次补丁也可能互相干扰。设置保存不上时，先怀疑其他插件。
皮肤显示异常：先核对HsSkins.cfg的 ID 写对没有，再试删除HsMod.cfg重新配置。
通用重置：删掉BepInEx\config\下相关的.cfg文件重新生成；仍无法解决时，把HsMod.cfg附在 issue 里再提问。

日常排查时还会用到两个文件：统计日志BepInEx\HsMatch.log（逗号分隔，路径可在设置里改）和 BepInEx 自身的运行日志。

常见问题 FAQ

不经过战网客户端能启动吗？

可以。在炉石根目录放一个client.config，写入[Aurora]段的VerifyWebCredentials = "TOKEN"（Token 从对应地区战网登录链接的跳转地址中获取，取?ST=之后、&accountId=之前的部分；国服Env值为cn.actual.battlenet.com.cn，其他地区一般取 Token 前两位对应）。配置好后运行Hearthstone.exe VerifyWebCredentials即可启动，无需打开战网客户端；Token 过期后更新一下该文件即可。

macOS / Linux 怎么装？

思路与 Windows 一致，差异在几处：

macOS：用 BepInEx 5 的 macos universal 包；运行时库改用项目里的HsMod/UnstrippedCorlibUnix（注意 Mono 和 Unity 版本要和炉石匹配）；在run_bepinex.sh中设置executable_name="Hearthstone.app"，并把ARCHPREFERENCE改为x86_64——炉石目前还没有 arm64 原生支持。
Linux：先通过社区方案装好炉石 Linux 客户端（通常会帮你配好client.config），BepInEx 用 unix 版 v5 包，运行时库同样来自HsMod/UnstrippedCorlibUnix，设置DOORSTOP_CORLIB_OVERRIDE_PATH和executable_name后用./run_bepinex.sh启动。