企业官网建设流程全解析

炉石传说 HsMod 插件完整指南：安装、配置与常用功能快速上手

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

如果你每天要花大量时间刷任务、开包、收奖励，又不想反复点同样的按钮，那么 HsMod 值得了解一下。它是一个基于 BepInEx 框架的炉石传说本地修改插件，能加速对局节奏、批量处理重复操作、清理干扰界面，并支持酒馆战棋数据记录和皮肤自定义。全文覆盖安装、配置、快捷键和排错，读完即可上手。

先想清楚：你被哪些重复劳动拖慢了

大多数炉石玩家的时间都花在三类事情上：

• 机械操作：开包、收奖励、分解卡牌、换卡组，每步都要手动点一遍；
• 界面噪音：匹配失败弹窗、广告提示、结算提示、对手表情包，不断打断专注；
• 等待耗时：对战动画、观战、日常任务的对局时间，纯等没有意义。

HsMod 的思路不是替你打牌，而是把这三类时间压到最低：对局可以用时间齿轮加速（默认最高 8 倍，配置上限 32 倍），奖励和开包可以批量自动完成，弹窗和提示可以按项屏蔽。

需要说明的是：HsMod 定位是学习与研究用途的开源项目（AGPL-3.0 协议），它不收集任何个人信息，纯本地运行。但其中部分功能（如自动操作、屏蔽反作弊、模拟开包）属于对客户端行为的修改，是否影响你的账号安全由你自己判断，下文会专门讲风险。

HsMod 是什么：一个跑在 BepInEx 5 上的炉石插件

从技术上看，HsMod 是一个标准的 BepInEx 插件：游戏启动时通过 Harmony 对客户端的指定方法打补丁，再在内存里叠加自己的逻辑。项目结构大致如下：

几个影响使用的前提，先记住：

1. 必须使用BepInEx 5 系列（BepInEx 6 尚未适配）；
2. 2026 年 7 月 1 日起炉石为 64 位程序，请使用x64 版本；
3. 炉石安装路径不能包含非拉丁字符（比如中文路径会直接导致失败）。

功能清单：按使用场景挑你需要的

几乎所有功能默认都是关闭的，需要在设置里逐项开启。按场景分组如下：

对局加速与挂机

• 时间齿轮加速：默认上限 8 倍，可在配置中放宽到 32 倍，配合快捷键逐档调节；
• 禁用掉线检测，支持长时间无操作挂机；
• 自动领取竞技场、对决、佣兵等模式奖励，结算后自动开包；
• 快速开包（空格一次开 5 包），可选对可全额分解的卡自动分解；
• 自动轮换卡组，观战好友时自动看双方视角。

界面净化与查询

• 屏蔽"无法匹配"等弹窗、广告与削弱公告提示、结算推荐；
• 移除窗口焦点要求和窗口大小限制；
• 收藏卡牌显示真实数量（不再只显示 9+）；
• 右键卡牌直接显示 DbId，方便查卡；
• 显示帧率并可修改游戏帧率。

酒馆战棋增强

• 观战/排行榜覆盖层显示对手 MMR（局内后台加载）；
• 每局天梯赛后记录名次、分差与英雄到 CSV，并提供按今日/7 天/本月/全时段、单人/双人的图表统计；
• 商店阶段专属快捷键：刷新、冻结、升酒馆、英雄技能、队友棋盘，均可自定义；
• 开局自动屏蔽对手全部表情（默认关闭）。

皮肤与外观

• 修改匹配英雄皮肤、酒馆皮肤、终结特效、幸运金币、面板背景等，配置写入Hearthstone\BepInEx\config\HsSkins.cfg；
• 修改卡牌背面，局内自动生效；
• 佣兵模式支持随机皮肤、强制钻石皮肤等选项。

进阶与开发向

• 进入炉石开发者模式；
• 模拟开包（随机或固定结果，可指定类型、数量、稀有度）；
• 模拟 iOS/Android 设备信息，用于收集其他设备的卡背；
• 用金币购买部分冒险内容；
• 内置 Showinfo Web 页面（默认端口 58744），展示佣兵进度、开包历史等信息。

安装步骤：在 Windows 上最快跑通 HsMod 插件

以 Windows 为例，整个过程分四步，全程只需复制文件、改一行配置。

第 1 步：准备插件本体

从项目 Releases 下载HsMod.dll，或自行编译（见后文源码编译小节）。

第 2 步：部署 BepInEx 5

下载 BepInEx 5 的x64版本，解压到炉石根目录（Hearthstone\），解压后目录内会出现BepInEx\和doorstop_config.ini。

第 3 步：放入非剥离库

创建Hearthstone\BepInEx\unstripped_corlib\目录，把项目中 HsMod/UnstrippedCorlib/ 下的所有 DLL 复制进去。然后编辑Hearthstone\doorstop_config.ini，加入或修改一行：

dll_search_path_override = BepInEx\unstripped_corlib

第 4 步：安装插件并启动

把HsMod.dll放进Hearthstone\BepInEx\plugins\，正常启动游戏。首次启动会自动生成配置文件BepInEx\config\HsMod.cfg。

进入游戏后按Esc打开菜单，点击新增的Mod Settings按钮即可进入带分类、搜索和按键捕获功能的设置面板。

macOS / Linux 差异点

• macOS：使用 BepInEx 的 macOS universal 包，非剥离库改用 HsMod/UnstrippedCorlibUnix/（Mono 与 Unity 版本需与客户端匹配）；在run_bepinex.sh中设置dll_search_path_override与executable_name="Hearthstone.app"，并将ARCHPREFERENCE改为x86_64（炉石暂无 arm64 版）。启动方式为./run_bepinex.sh TOKEN；
• Linux：通常先用社区方案装好 Linux 版炉石（一般会自动配好client.config），再部署 BepInEx unix 版，run_bepinex.sh中设置DOORSTOP_CORLIB_OVERRIDE_PATH与executable_name="Bin/Hearthstone.x86_64"，并用sed -i "s/\r/ /g"清理行尾符；
• 两个平台最后同样把HsMod.dll放入BepInEx/plugins目录。

从源码编译

需要 .NET SDK 8.x，产物为./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

构建完成后的install.bat会把编译好的 DLL 复制到默认的炉石安装目录（前提是该目录已配好 BepInEx）。

用 client.config 实现令牌登录

HsMod 支持VerifyWebCredentials令牌登录，这样可以直接命令行启动游戏，不依赖战网客户端常驻。在Hearthstone.exe同级目录创建client.config：

[Config] Version = 3 [Aurora] VerifyWebCredentials = "你的令牌" ClientCheck = 0 Env.Override = 1 Env = us.actual.battle.net

两点注意：

• Env的值跟随区服，国服为cn.actual.battlenet.com.cn，其他区一般与令牌前两位一致；
• 令牌来自战网登录跳转链接中ST=之后、&accountId=之前的部分。令牌过期后游戏会打不开，重新获取并更新即可。

启用插件后，也可以直接命令行传参启动：./Hearthstone.exe VerifyWebCredentials，不再强制要求client.config存在。

常用快捷键与配置约定

除了齿轮加速使用方向键外，其余快捷键大多可在 Mod Settings 中自定义：

版本号的含义也值得知道，例如3.0.0.0：第一位对应当前炉石大版本；第二位是炉石在该版本内的更新计数（未改动Assembly-CSharp.dll的更新不计）；第三位是功能新增计数，随第二位变化归零；第四位是修复版本。炉石更新后如果插件还能正常运行，就不必急着换新版。

风险提示与常见问题

关于账号安全。中国大陆客户端默认启动反作弊 SDK，HsMod 会尝试屏蔽相关反作弊功能，但官方明确说明无法保证账号安全。如果你在意这一点，建议只使用界面类功能，避免挂机、模拟、屏蔽类选项。

功能冲突。HsMod 可能与其他修改Assembly-CSharp.dll的模组冲突——直接改动该 DLL 会使 IL 偏移错位，导致补丁失效；与其他 BepInEx 插件重复修补同一方法时也可能冲突。发现"设置不保存"时，先检查是否启用了其他炉石插件。

出问题怎么办。按这个顺序排查：

1. 删除BepInEx\config\下对应的.cfg文件，重新进游戏生成配置；
2. 确认安装路径全为拉丁字符、BepInEx 版本为 5 系列 x64；
3. 皮肤显示异常时检查HsSkins.cfg，并尝试删除HsMod.cfg重建；
4. 仍无法解决时，把HsMod.cfg附上提交到项目 issue。

数据文件位置。战棋战绩记录在BepInEx\HsMatch.log（逗号分隔字段，路径可在设置中修改）；GetHsLib.py用于更新炉石自身的运行时库。

写在最后

HsMod 把炉石里最磨人的重复劳动交给了脚本，把时间还给了真正需要你动脑的对局。先装上它，进游戏按Esc打开 Mod Settings，从时间齿轮和弹窗屏蔽这两个功能开始，按需逐项开启。

如果你已经准备好，现在就按"安装步骤"一节把 x64 版 BepInEx 5 放进炉石目录，十分钟之后，你的日常任务流程会明显变快。

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