炉石 HsMod 插件实用指南:5分钟装好,变速、自动开包与战棋统计一次配齐
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一个基于 BepInEx 的免费开源炉石插件(AGPL-3.0 协议,不收集任何数据),覆盖炉石变速、自动开包、弹窗屏蔽、对手段位昵称显示、酒馆战棋 MMR 与战绩统计这几类高频需求。下面按"先看能干什么、再装、再按场景配置、最后排错"的顺序讲,装完即可进游戏按 Esc 打开设置面板使用。
功能总览:HsMod 到底能做什么
几乎所有功能默认关闭,在设置面板里手动开启即可。先按类别过一遍,心里有个数:
| 功能类别 | 代表能力 | 默认状态 | 备注 |
|---|---|---|---|
| 界面与体验 | 时间档位最高 8 倍速(配置上限 32 倍)、帧率显示与调整、解除窗口失焦限制与缩放限制、屏蔽弹窗/削卡提示/结算提示 | 关 | 设置面板中逐项开启 |
| 自动化挂机 | 空格一次开 5 包、可自动分解全额返尘卡;竞技场/对决/佣兵奖励自动领取并拆包;禁用掉线断线以长时间挂机 | 关 | 挂机类适合无人值守场景 |
| 对局信息 | 对手完整战网昵称、传说以下显示天梯等级、标记对手已打出的已知卡牌 | 关 | 匹配阶段即可生效 |
| 酒馆战棋 | 排行榜悬浮层显示对手 MMR(单排/双排);每局名次、分差、英雄写入 CSV,图表支持今天/7天/月/全部与单双排筛选;商店刷新、冻结、升级快捷键仅在购物阶段生效 | 关 | 战棋专属组合 |
| 皮肤外观 | 英雄皮肤、卡背、酒馆面板、幸运币等;佣兵随机皮肤、强制钻石皮肤 | 关 | 改HsSkins.cfg或界面编辑 |
| 表情互动 | 屏蔽对手表情/思考表情、静音鲍勃、跳过开场英雄介绍、表情冷却最低 1.5 秒、表情快捷键 | 关 | 可按对手逐个屏蔽卡牌特效 |
| 模拟与开发 | 模拟开包(自定义类型/数量/稀有度)、模拟断线重连、金币购买纳克萨玛斯等冒险、开发者模式入口 | 关 | 面向研究与测试 |
| Web 数据 | 本地服务默认监听 58744 端口,查看佣兵养成进度与开包历史;/shell路径 Webshell 需单独开启 | 关 | 云服务器注意防火墙 |
实现上,各功能分散在 HsMod/Patches/ 目录下的若干补丁文件中,例如PatchBgsRank.cs对应战棋 MMR、PatchFakePackOpening.cs对应模拟开包,想查某个功能的实现入口可以直接从这里找。
安装步骤:Windows 下 5 步装好 HsMod
📌 版本选择有硬性要求:只用 BepInEx 5 系。BepInEx 6 目前仍是预览版、尚未适配;炉石自 2026 年 7 月 1 日起转为 64 位程序,所以选 BepInEx 的 x64 构建。
拿插件本体:从 Release 下载现成的
HsMod.dll,或从源码编译(见下节)。解压 BepInEx:把 BepInEx 5 x64 版解压到炉石根目录
Hearthstone\。补齐运行库:新建
Hearthstone\BepInEx\unstripped_corlib\,把项目 HsMod/UnstrippedCorlib/ 目录里的全部 DLL 复制进去。这一步决定插件能否正确引用游戏内部库,是最容易漏的一环。改加载器配置:编辑炉石根目录的
doorstop_config.ini,指定 DLL 搜索路径:dll_search_path_override = BepInEx\unstripped_corlib旧版 BepInEx(5.4.23.2 之前)的键名是
dllSearchPathOverride,写法不同,以所装版本的默认文件为准。放入插件并启动:
HsMod.dll放到Hearthstone\BepInEx\plugins\,正常启动游戏。
⚠️ 炉石安装路径不能包含中文或其他非拉丁字符,否则插件可能直接加载失败。动手之前先检查一遍路径。
从源码编译 HsMod.dll
编译需要 .NET SDK 8.x,产物与 Release 现成版等价:
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。仓库里还有两个辅助脚本:HsMod/GetHsLib.py用于更新炉石自身的运行库,HsMod/install.bat在 BepInEx 已配置好时会把编译好的 DLL 复制到默认炉石安装目录。
macOS 与 Linux 的差异
- macOS:用 BepInEx 的 macos_universal 版(5 系),运行库改从 HsMod/UnstrippedCorlibUinx/ 取(Mono 和 Unity 版本需与炉石匹配);在
run_bepinex.sh中设置executable_name="Hearthstone.app"、dll_search_path_override="BepInEx/unstripped_corlib",并把ARCHPREFERENCE改成x86_64——炉石目前还不是 arm64 原生。最后chmod u+x run_bepinex.sh,配合战网登录令牌启动。 - Linux:先用 hearthstone-linux 项目装好炉石(通常会顺带生成
client.config),解压 BepInEx Unix 版(5 系),脚本里executable_name写Bin/Hearthstone.x86_64、DOORSTOP_CORLIB_OVERRIDE_PATH指向unstripped_corlib,再用sed -i "s/\r/ /g"修正换行符后./run_bepinex.sh启动。
进游戏后:找到 Mod Settings
游戏菜单里会出现Mod Settings按钮(Esc 打开主菜单即可看到),点进去就是完整配置面板:分功能类别、带搜索框、支持按键捕获重绑。按钮也可以隐藏,另有网页版设置作为备用入口。进游戏第一件事就是逛一遍这个面板,把想用的功能勾上。
高收益的三个配置场景
变速与跳动画:8 倍速直接生效
原版的齿轮只能小幅调节时间,HsMod 直接按档位跳:默认时间档位拉到 8 倍速即可,配置文件上限可写到 32 倍(取值范围 -32 到 32)。收益最大的场景是开包、过动画和回合等待——以开 100 包为例,原速要逐个等动画、大约 20 分钟起步;用空格一次开 5 包加上快进,整个流程能压到 5 分钟左右。战棋里还有个"快速战斗"选项,可跳过部分战斗动画,比齿轮更顺滑,并在释放终结技时屏蔽特效。
对局信息差:段位、昵称与手牌推算
匹配进局后,对手昵称旁会显示完整战网昵称,可以直接加好友;传说以下还会标出对手的天梯等级。对手已经打出来的已知卡牌会被标记,方便推算其手牌余量。表情类干扰可以一并处理:屏蔽对手表情和思考表情、静音酒馆鲍勃、跳过匹配时的英雄介绍,表情冷却最短可压到 1.5 秒,并支持快捷键快速发问候、惊叹。
酒馆战棋:MMR 显示与 CSV 战绩统计
战棋是信息差最值钱的模式。HsMod 在匹配开始时会后台加载数据,把对手 MMR 直接显示在排行榜悬浮层每个玩家名下(单排、双排都支持)。每局天梯对局的名次、MMR 变化、英雄会追加写入 CSV(日志文件为BepInEx\HsMatch.log,逗号分隔,路径可在设置中配置),配套图表支持按今天 / 7 天 / 月 / 全部以及单排 / 双排筛选。商店刷新、冻结、酒馆升级、英雄技能、双排查看队友面板都能绑快捷键,且只在购物阶段生效;开局还可以自动屏蔽全场对手表情。
皮肤与卡背:改 HsSkins.cfg 或界面编辑
英雄皮肤(匹配/酒馆)、终结技特效、面板、幸运币、卡背等都能换。两种改法:编辑Hearthstone\BepInEx\config\HsSkins.cfg(首次运行自动生成),或直接在设置界面里改。对局中修改皮肤后按 F4 保存,再模拟一次断线重连,新外观立即生效。佣兵相关还有随机皮肤、强制钻石皮肤等选项。
Web 数据页、F4 与开发者功能
58744 端口:佣兵进度与开包历史
内置 Web 服务(Showinfo)默认监听 58744 端口,且一般监听本机所有 IP。游戏启动后浏览器打开本机对应地址,可以看到佣兵养成进度、开包历史等内容,页面模板在 HsMod/WebResources/ 目录。
🔒
/shell路径的 Webshell 命令执行必须在设置中手动开启,建议只在内网环境使用;如果用云服务器跑炉石,记得在防火墙和安全组放行 58744 端口,否则外部访问不到。
F4:插件唯一的固定按键
F4 是写死的快捷键,管三件事:导出部分游戏内信息(存到Hearthstone\BepInEx\下)、更新皮肤配置、重启 Web 服务。其余快捷键都可在设置面板里重绑。
模拟与开发者功能
- 模拟开包:可自定义类型、数量、稀有度、品质,随机或固定结果,方便批量测试。
- 模拟断线重连:需要绑快捷键,皮肤更新后靠它生效。
- 冒险购买:金币购买纳克萨玛斯、黑石山、探索者联盟等冒险;卡拉赞支持但打不了序章,且需通关才能跳关。
- 开发者模式:保留进入炉石开发者模式的入口。
- 免战网启动:
client.config放在Hearthstone.exe旁边,从战网登录 URL 回调中取http://localhost:0/?ST=之后、&accountId=之前的令牌填入VerifyWebCredentials;插件启用后直接./Hearthstone.exe VerifyWebCredentials也能启动,令牌过期后更新即可。
关于版本号的四段规则
以3.0.0.0为例:第一位对应炉石主版本,第二位是该版本内炉石更新次数(Assembly-CSharp.dll这类核心文件没变则不递增),第三位是 HsMod 新增功能次数,第四位是编译号、主要记录 bug 修复。所以炉石更新后插件如果还能正常跑,不必急着换新版。
常见问题与使用边界
- 插件没反应:依次检查 BepInEx 是否装完整、
unstripped_corlib的 DLL 是否齐全、HsMod.dll是否在plugins目录,最后看启动日志里的加载记录。 - 设置存不上:先停用其他炉石插件排除冲突(修改过
Assembly-CSharp.dll的其他 Mod 会打乱 IL 偏移,导致补丁失效),再删掉BepInEx\config\下对应配置让其重新生成。 - 皮肤显示异常:检查
HsSkins.cfg格式,必要时删除HsMod.cfg让它重新生成默认配置。 - Web 服务连不上:确认 58744 未被防火墙拦截、功能确实已开启,再看日志中的服务状态。
- 反馈问题:按官方建议附带
HsMod.cfg提交 issue。
⚠️ 边界说明:大陆客户端默认启用反作弊 SDK,HsMod 会尝试屏蔽相关功能(见
HsMod/Patches/PatchAntiCheat.cs),但无法百分百保证账号安全。原则是只开影响自己体验的功能——变速、皮肤、信息展示类,不去干扰别人的对局。
💡 翻译与本地化:界面文案在 HsMod/Languages/ 下,有简中、繁中、英、日、韩等 15 个语言文件,改完 JSON 重新编译即可生效。
上手行动清单
- 第一局:装好后只开三个开关——炉石变速(先拉到 8 倍)、窗口失焦限制解除、弹窗屏蔽,打一局找节奏;
- 攒包与结算:再开自动开包(空格连开 + 自动分解全额返尘)和自动领奖,把结算环节交给插件;
- 进阶:最后试 Web 数据页(58744)和模拟开包等开发者功能,稳定后再回头配置战棋的 MMR 显示、CSV 统计和商店快捷键。
完整文档以仓库 ReadMe 与 Wiki 为准,各功能的具体开关名可在设置面板内用搜索框直接查。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考