☰
炉石 HsMod 插件实用指南:5分钟装好,变速、自动开包与战棋统计一次配齐
2026/10/26 1:23:53 网站建设 项目流程

炉石 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 构建。

  1. 拿插件本体:从 Release 下载现成的HsMod.dll,或从源码编译(见下节)。

  2. 解压 BepInEx:把 BepInEx 5 x64 版解压到炉石根目录Hearthstone\。

  3. 补齐运行库:新建Hearthstone\BepInEx\unstripped_corlib\,把项目 HsMod/UnstrippedCorlib/ 目录里的全部 DLL 复制进去。这一步决定插件能否正确引用游戏内部库,是最容易漏的一环。

  4. 改加载器配置:编辑炉石根目录的doorstop_config.ini,指定 DLL 搜索路径:

    dll_search_path_override = BepInEx\unstripped_corlib

    旧版 BepInEx(5.4.23.2 之前)的键名是dllSearchPathOverride,写法不同,以所装版本的默认文件为准。

  5. 放入插件并启动: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 重新编译即可生效。

上手行动清单

  1. 第一局:装好后只开三个开关——炉石变速(先拉到 8 倍)、窗口失焦限制解除、弹窗屏蔽,打一局找节奏;
  2. 攒包与结算:再开自动开包(空格连开 + 自动分解全额返尘)和自动领奖,把结算环节交给插件;
  3. 进阶:最后试 Web 数据页(58744)和模拟开包等开发者功能,稳定后再回头配置战棋的 MMR 显示、CSV 统计和商店快捷键。

完整文档以仓库 ReadMe 与 Wiki 为准,各功能的具体开关名可在设置面板内用搜索框直接查。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询