HsMod 炉石插件实战教程：3 步装好，日常从 8 倍速推到 32 倍速
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是基于 BepInEx 5 框架、用 Harmony 热补丁（只改运行时行为、不动游戏本体文件）写成的炉石传说增强插件，AGPL-3.0 协议、不收集任何用户数据，支持 Windows / macOS / Linux。它专治三件事：日常流程太慢、界面不可定制、局内信息不透明。适合想给刷日常提速、换皮肤、看对手信息的玩家。
装机前先把 4 个条件核对一遍
少走回头路的关键全在这一步：
- BepInEx 必须选 5 系列的 x64 包。炉石客户端从 2026-07-01 起变成了 64 位程序，而 BepInEx 6 还在预发布、尚未适配，所以 BepInEx 5 + x64 是当前唯一稳妥组合。
- 游戏安装路径的任何一层目录都不能含中文或其他非拉丁字符（最高频的坑）。注意是"任何一层"，
D:\游戏\炉石这种路径第一个字就废了，先检查再动手。 - 准备好项目里对应平台的运行时 DLL：Windows 用
HsMod/UnstrippedCorlib，macOS/Linux 用HsMod/UnstrippedCorlibUinx。 - 只有打算自己编译才需要 .NET SDK 8.x；直接用 Release 版
HsMod.dll的话这条可以跳过。
Windows 三步装好，卡住多半在第三步
第 1 步：拿到HsMod.dll。二选一：从 Releases 下载，或者自己编译（产物在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\BepInEx\和Hearthstone\doorstop_config.ini），再新建Hearthstone\BepInEx\unstripped_corlib\，把HsMod/UnstrippedCorlib下的 DLL 全部拷进去。
第 3 步：改doorstop_config.ini并放插件。这是新手最容易翻车的一步：5.4.23.2 及以上版本键名是dll_search_path_override，更老的版本是dllSearchPathOverride（没有下划线），拼错等于白配：
[dll_search_path_override] value = BepInEx\unstripped_corlib最后把HsMod.dll放进Hearthstone\BepInEx\plugins\，启动游戏。进去后按Esc打开Mod Settings面板——注意绝大多数功能默认是关闭的，要逐项手动开启，这是装完之后"感觉什么都没发生"的第一原因；如果面板压根没出现，回头核对你用的是不是 BepInEx 5 的 x64 包。
齿轮变速：日常刷到 8 倍，配置一改能到 32 倍
怎么做：设置里打开齿轮开关后，直接用方向键切档——上/下键加减速，左/右键分别回默认档和最大档。
效果：动画全部保留、只是整体节奏变快，打日常的同时顺手刷金币，手感不糊。
参数与进阶：默认最大 8 倍速；想推极限，编辑HsMod.cfg里的timeGear（默认 0，允许范围 -32 到 32），填 32 即上限 32 倍速。负数是减速，1 和 0 效果相同。想要更干脆就开"快速模式"（Fast battle）：直接跳过大部分动画，放终结技时连特效一起屏蔽，佣兵 PvE 的酒馆同样适用（最后死亡结算偶尔会卡一下）。再配合"禁用掉线检测"，长时间不操作也不会被踢。懒人玩法：启动参数带afk=1，插件自动套上挂机模板（齿轮置零 + AwayFromKeyboard 配置），面板都不用进；afk实际支持 0~4 共五种模式，0 是禁用、2/3/4 是各种反挂机组合，细节以HsMod/Main.cs为准。
翻车提醒：加速和禁用掉线检测建议一次配齐，之后就不用惦记了；只开一半（比如忘了禁掉线检测）刷着刷着被踢反而更亏。
皮肤与卡背：F4 导出 ID，再写映射
所有外观替换集中在Hearthstone\BepInEx\config\HsSkins.cfg（首次运行自动生成）。可替换对象：匹配/酒馆英雄皮肤、终结特效、匹配与酒馆面板、幸运金币、卡背、表情边框等。
怎么做，两步：
- 按F4，插件把当前全部皮肤信息（含 DbId）导出到 BepInEx 目录，照着它查原始皮肤 ID；
- 在
HsSkins.cfg里按原始ID:替换ID写映射。想随机皮肤就写多值，例如a:b,c,d。
进阶与生效时机：改完再按一次 F4 更新配置；如果正在对局中，还要触发一次模拟断线才生效。卡背比较省事，配置后局内自动生效，无需额外操作。
翻车提醒：换了 ID 没反应，先核对映射值写没写错，再不行删掉HsMod.cfg重新配一遍。
58744 端口的 Web 面板：备用配置口 + 数据页
插件自带 Web 服务，默认端口58744（HsMod.cfg里webServerPort可调，范围 1~65535）。启动游戏后浏览器访问本机该端口：
/config：网页版配置管理。游戏内面板不好用时当备用入口；/shell：WebShell，默认关闭，要显式开启，且中文显示可能乱码；- Showinfo 页面：佣兵养成进度、开包历史等，佣兵玩家会常用。
两个提醒：按 F4 会顺带重启这个 Web 服务；端口默认监听所有本地 IP，炉石跑在云服务器上时记得检查防火墙和安全组，别把它暴露出去。
其余功能速览：默认全关，按需勾
以下功能都在设置面板里，默认全部关闭，挑你需要的勾：
酒馆战棋
- 排行榜覆盖层在每个玩家名下显示 MMR（双人模式匹配开始时后台加载）
- 每局天梯的排名、MMR 变化、英雄写入 CSV（默认
BepInEx\HsMatch.log，路径可在设置改），页面提供今日 / 7 天 / 本月 / 全部图表 - 刷新、锁刷新、酒馆升级、英雄技能、看队友棋盘五件套快捷键可重绑，仅购物阶段生效
- 开局自动屏蔽所有对手表情
对手信息
- 显示完整战网昵称，对手可加为好友
- 显示传奇之前的天梯等级；对手已知卡牌打标记
- 可单独屏蔽某个对手的卡牌特效；点酒馆玩家头像取昵称
表情
- 自动屏蔽对手表情、屏蔽思考表情、屏蔽布伯语音
- 自己发表情无冷却（最小间隔 1.5 秒），六种常用表情（问候/打得好/感谢/哇/失误/挑衅）各有快捷键
开包与自动化
- 空格一次开 5 包；可选"开包时自动分解可全额返还的卡"
- 一键分解整副可退牌组、一键清除收藏
new!标记、收藏夹卡牌数显示真实数字（不再 9+） - 自动领取竞技场/对战/佣兵奖励（结束打开奖励包）；自动举报并可生成交互日志
- 观战好友时自动看双方、自动换牌；0-0 无牌组直接投降；快捷键静音
界面与其他
- 解除窗口焦点与缩放限制；显示/修改帧率
- 屏蔽匹配失败、推广、结算奖励、成就等各类弹窗
- 右键选中卡牌显示 DbId；跳过匹配英雄介绍；屏蔽主播模式误触
- 金卡/钻卡外观、佣兵随机皮肤、金币卡等外观选项
版本号怎么读：炉石更新后别急着换插件
以12.1.0.1为例：第 1 位对应炉石主版本号；第 2 位是该版本内炉石更新且改动了Assembly-CSharp.dll等文件的次数（没改到的更新不算）；第 3 位是新增功能时 +1，第 2 位变化时清零；第 4 位是编译版本，主要跟随第 3 位的 bug 修复。
实用结论：炉石更新后插件不一定坏，功能都正常就没必要急着换新版。
翻车了按这个顺序查
| 现象 | 原因 | 修复动作 |
|---|---|---|
| 插件加载不了（最高频） | 安装路径某层含中文/非拉丁字符 | 整条路径全部改成纯拉丁字符 |
| 面板不出现 | 用了 BepInEx 6 或非 x64 包 | 换 BepInEx 5 x64 重新部署 |
| 设置保存不上、补丁失效 | 其他 mod 改了Assembly-CSharp.dll导致 IL 偏移错位，或佣兵类/MixMod 类插件对同一方法二次补丁 | 先怀疑并禁用其他插件再试 |
| 皮肤显示异常 | HsSkins.cfg里 ID 写错 | 核对映射值；仍不行删HsMod.cfg重新配置 |
| 以上都无效 | 配置残留 | 删BepInEx\config\下相关.cfg重新生成 |
排查时两份取证位置：统计日志BepInEx\HsMatch.log（逗号分隔）和 BepInEx 自身运行日志；提 issue 时按项目要求附上HsMod.cfg。
高频问题 FAQ
macOS / Linux 怎么装？结论：思路与 Windows 一致，只是运行时库和启动脚本不同。macOS 用 BepInEx 5 的 macos universal 包，运行时 DLL 换成HsMod/UnstrippedCorlibUinx（Mono 和 Unity 版本必须与炉石匹配），在run_bepinex.sh里设executable_name="Hearthstone.app"并把ARCHPREFERENCE改成x86_64——炉石目前没有 arm64 原生支持。Linux 先用社区方案（hearthstone-linux）装好客户端（一般会帮你配好client.config），BepInEx 用 unix 版 v5 包，设好DOORSTOP_CORLIB_OVERRIDE_PATH和executable_name="Bin/Hearthstone.x86_64"后跑./run_bepinex.sh。
哪些快捷键是写死的？只有F4：导出局内信息（存到 BepInEx 目录）、更新皮肤配置、重启 Web 服务三件事都挂在它上面，改不了。其余快捷键——加速档切换、模拟断线、投降、静音、开包、酒馆五件套、六种表情——全部可在设置面板重绑。
国服用会不会封号？如实说：国服客户端默认启用反作弊 SDK，HsMod 会尝试屏蔽相关功能，但无法保证账号安全。项目定位为学习与研究用途，风险需要自行评估；在意账号的话，建议把修改功能留在非主力环境使用。
不经过战网客户端能启动吗？可以。在炉石根目录放一个client.config，在[Aurora]段写VerifyWebCredentials = "TOKEN"——Token 从对应地区战网登录链接的跳转地址中取?ST=之后、&accountId=之前的部分；国服Env值为cn.actual.battlenet.com.cn，其他地区一般取 Token 前两位对应。配好后运行Hearthstone.exe VerifyWebCredentials即可启动，Token 过期后更新该文件。
炉石更新后必须升插件吗？不必须。按版本规则看，更新没改到Assembly-CSharp.dll时第 2 位都不变，插件大概率照跑；功能正常就别动，功能坏了再回 Releases 找新版。
更多安装细节、全部设置项与各补丁实现，查项目根目录的 ReadMe.md 与补丁源码目录 HsMod/Patches/。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
