HsMod 炉石传说插件完整指南：皮肤、变速与战棋辅助快速上手-平芜编程栈

HsMod 炉石传说插件完整指南：皮肤、变速与战棋辅助快速上手

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

HsMod 是基于 BepInEx 的炉石传说开源增强插件，把卡牌镀金、8 倍速、酒馆战棋 MMR 显示、挂机自动化等 60 多项能力装进同一个 DLL。这么强的工具，你敢用在主号上吗？

需不需要装炉石插件：3 秒决策

先给结论：只想要外观类和对战加速功能的人值得装，想碰交易类功能的人先想清楚封号成本。

适合谁：刷任务想省时间、战棋玩家想看对手分数、收藏党想改皮肤
解决什么：官方客户端不提供速度调节、外观映射和本地统计，HsMod 把这些全做了
风险预告：大陆客户端默认运行暴雪反作弊 SDK，插件会尝试屏蔽检测，但作者明确声明无法保证账号绝对安全

就像点外卖前先看菜单——你只点自己想吃的菜，就不会被整桌硬菜砸到钱包。下面这份"菜单"分四类。

一句话说清 HsMod 是什么

一句话：HsMod 是塞给炉石客户端的一份"自定义菜单"，BepInEx 负责把菜单递进厨房，你只负责勾选。

几个高频名词，每个记一行就够：

BepInEx：开源的 Unity 插件加载框架，v5.x 稳定可用，v6 仍在预览期、HsMod 暂不兼容
DLL：插件编译产物，放进BepInEx\plugins即被识别
反作弊 SDK：大陆客户端默认启动的暴雪监控程序，插件尝试屏蔽其相关检测
F4：固定快捷键，负责导出对局信息、刷新皮肤配置、重启 Web 服务，不可重绑

功能菜单：按使用场景点单

日常对局与外观

卡牌镀金/钻石⭐：普通卡以金色或钻石特效渲染，纯本地显示，适合收藏党
皮肤自定义：英雄皮肤、卡背、幸运币、对战面板、酒馆面板、终结特效、宠物都能换，适合爱折腾的人
变速齿轮：最高 8 倍速（可配置至 32 倍），跳过冗长动画，适合刷任务
快速战斗：跳过部分动画，酒馆与佣兵 PvE 局更顺滑
帧率显示与锁定：看 FPS、手动改帧率，适合老机器排查卡顿

酒馆战棋

对手 MMR 显示⭐：排行榜上直接显示每个对手的隐藏分，双排同样生效
对局统计：排名、分差、英雄记入 CSV，生成今日/7 天/本月/全部趋势图，适合复盘
商店快捷键：购物阶段一键刷新、冻结、升酒馆、放技能，双排还能偷看队友棋盘
自动静默：开局屏蔽所有对手表情（默认关闭），适合不想被骚扰的人
本地解锁藏品：酒馆外观本地显示为已拥有，纯养眼

挂机与自动化

AFK 模板⭐：一键套用挂机配置，自动领竞技场/佣兵奖励、屏蔽弹窗
开包加速：空格连开，可自动分解全额返尘的卡
定时退出：设定时长，到点自动关游戏，配合挂机场景
断线保护：允许长时间无操作不被踢，挂机党必备

模拟与开发者工具

模拟开包：自定义卡包类型、数量、稀有度、品质，看全金效果随便配
设备模拟：伪装 iOS/安卓设备领取对应平台卡背
Web 信息面板：默认端口 58744，浏览器看对局统计、开包记录
开发者模式：解锁游戏隐藏开发者选项，HsMod/Patches/ 下每个补丁文件对应一组开关

装前自查：系统、路径与冲突清单

安装前花一分钟对照这张清单，能省掉八成排查时间：

系统：Windows 用 64 位客户端（炉石 2026 年 7 月起为 64 位程序），BepInEx 必须选 x64 的 5.x
路径：炉石安装目录不能包含中文等非拉丁字符，这是硬性要求
版本：BepInEx 用 5.x；从源码编译才需要 .NET SDK 8.x
冲突：不要与修改Assembly-CSharp.dll的模组共存，IL 偏移错位会导致补丁失效
冲突：避免其他 BepInEx 插件修补同一方法，插件不会检测原方法是否已被改
保险：装之前备份整个 Hearthstone 文件夹

炉石插件分步安装：从 0 到能玩

以 Windows 为例，照做大约五分钟。

下载 BepInEx x64（5.x）解压到炉石根目录Hearthstone\。常见坑：误选了 BepInEx 6 或 32 位包。
新建Hearthstone\BepInEx\unstripped_corlib\，把项目 HsMod/UnstrippedCorlib 里的全部 DLL 复制进去。常见坑：漏拷文件导致启动即崩。
编辑doorstop_config.ini：BepInEx 5.4.23.2 及以后设为dll_search_path_override = BepInEx\unstripped_corlib，旧版本用dllSearchPathOverride=。常见坑：两个键名混用。
把编译好的HsMod.dll放进Hearthstone\BepInEx\plugins，启动游戏。

备选路径：想自己编译可克隆仓库git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod，进入目录执行dotnet build --configuration Release；Linux 与 macOS 用户改用 BepInEx unix 版本，运行库取HsMod/UnstrippedCorlibUnix，并按各自说明改run_bepinex.sh后赋予执行权限启动。

装完怎么验证生效

验证顺序和改配置顺序一致，都从游戏内往外走：

游戏内菜单（首选）：Esc 打开菜单，找"Mod Settings"按钮——按钮出现了，就说明插件已加载成功
网页配置：浏览器访问http://127.0.0.1:58744/config，支持多语言与实时保存，页面 HsMod/WebResources/ 就是它的来源
配置文件：BepInEx\config\下的HsMod.cfg（主配置）与HsSkins.cfg（皮肤映射），手动党直接编辑

两点关键认知：

⚠️ 绝大多数功能默认关闭，装完没效果不是 bug，是你还没开
F4 是固定快捷键：刷新皮肤配置、重启 Web 服务、保存设置都靠它，改完配置记得按一下

看到游戏菜单多出按钮、网页面板能打开，这两条同时成立才算装好。

进阶玩法：三个老玩家招式

招式一：皮肤映射文件

目标：让指定英雄随机落到一组皮肤上。

打开BepInEx\config\HsSkins.cfg，按原皮肤ID:替换ID1,ID2格式写映射
进游戏按 F4 让配置生效
对局中修改时，需先关闭"报错退出"并允许弹窗，再用快捷键模拟拔线强制刷新

注意：ID 可右键卡牌查看 DbId，写错不会崩游戏，只会回退到原皮肤。

招式二：变速齿轮的档位

目标：把任务局时间压到最短而不翻车。

日常刷任务开 4 倍速，稳定性最好
想再压缩时间上 8 倍，动画跳过最明显
32 倍只留给测试环境，正常对局容易出现画面撕裂

招式三：无冷却表情

目标：用数字键 1-6 绑定表情，间隔最低 1.5 秒连续放，嘲讽效果拉满。

在设置菜单的按键绑定区按提示重绑
开启无冷却表情开关
对局中连续按数字键即可连发

出了问题怎么办：风险分级与排查顺序

先立风险清单，再谈排查。

🔴 高危：冒险购买（金买地宫、黑石山等）、卡拉赞强开/修复、零元购类功能——源码注释明确写了"有概率被封号"，没有小号别碰
🟡 中危：模拟开包可能触发自动断线重连；自动开包存在已知 bug；设备模拟领卡背后可能需要打一局匹配
🟢 低危：纯本地展示类——皮肤、镀金、MMR 显示、对局统计，改动不出本机

故障自查顺序，按这条线走别跳步：

先查BepInEx\config\下对应.cfg是否被写坏，删掉重配
再查HsSkins.cfg映射格式，皮肤错乱基本是它
设置保存不了，查是否开了其他炉石插件在打架
游戏打不开，看BepInEx\LogOutput.log，里面通常有明确报错
仍解决不了，把HsMod.cfg附在 issue 里反馈

高频问答

Q1：装了会被封号吗？结论：没有任何插件敢承诺 100% 安全，HsMod 不收集信息、开源可审计，风险主要来自高危功能。只开低危展示类功能、关掉交易类补丁，是普通用户的最优解。

Q2：装完游戏打不开了？结论：九成是前四步装错了。依次核对：BepInEx 是否在根目录、unstripped_corlib是否齐全、doorstop_config.ini键名与路径是否正确、安装路径是否含中文、插件与 BepInEx 版本是否匹配；最后看LogOutput.log定位。

Q3：炉石更新后要换插件吗？结论：不一定。版本号第一位对应炉石大版本，只有游戏更新改动了Assembly-CSharp.dll等关键文件才必须换新版。先试跑，能用就继续用。

Q4：能绕过战网客户端启动吗？结论：可以。配好client.config后执行./Hearthstone.exe VerifyWebCredentials即可免战网登录，挂机场景下非常省事；token 过期导致打不开时，更新client.config里的 token 再试。