HsMod:炉石传说 BepInEx 插件安装与配置完整指南
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一款运行在 BepInEx 框架上的炉石传说本地插件,用于调整对战节奏、简化重复操作并支持令牌登录。它适配 Windows、macOS、Linux,内置 15 种界面语言,全部功能默认关闭,由你逐项启用。
适用人群速览
先用一句话对号入座:
| 你的类型 | 主要收益 |
|---|---|
| 日常任务党 | 拆包、分解、领奖批量完成,界面干扰可逐项屏蔽 |
| 多账号 / 挂机玩家 | 用client.config令牌登录,绕开战网客户端反复切换 |
| 酒馆战棋玩家 | 排行榜显示对手 MMR,购物阶段一套商店快捷键 |
核心能力拆解
四个差异化能力点,均来自 ReadMe.md 与配置项定义:
- 变速齿轮|动画与结算按倍率加速,日常流程更快|倍率范围 -32 至 32,默认档位最高 8 倍,配置上限 32 倍;方向键即可切换
- 游戏内设置菜单|Esc 打开,支持分类、搜索和按键捕获,不必手改配置文件|另有网页端设置作为后备入口
- 酒馆战棋 MMR 与对局统计|排行榜直接标注对手分,牌力一目了然|每场排位的名次、MMR 变化、英雄记入 CSV,可按今天 / 7 天 / 本月 / 全部筛选
- 自动化与挂机|领奖、拆包、分解一键完成|
AwayFromKeyboard模板一次锁定自动开宝箱、防掉线等一组选项;拆包一次开五包,支持自动分解全额可退卡牌
安装配置三步走
以下以 Windows 为例,macOS / Linux 步骤见 ReadMe.md Installation 一节。
第一步:准备环境。安装 .NET SDK 8.x,下载 BepInEx 5 的x64压缩包(炉石自 2026-07-01 起为 64 位客户端,x86 包不可用)。BepInEx 6 仍在预发布,暂不兼容。游戏安装路径不能包含中文等非拉丁字符。
成功标志:炉石根目录出现BepInEx\和doorstop_config.ini。
第二步:安装插件。将项目 HsMod/UnstrippedCorlib 中的全部 dll 复制进Hearthstone\BepInEx\unstripped_corlib\,把HsMod.dll(从 Releases 下载或自行编译)放进Hearthstone\BepInEx\plugins\,并编辑doorstop_config.ini:
dll_search_path_override = BepInEx\unstripped_corlib旧版 BepInEx 需写成dllSearchPathOverride=BepInEx\unstripped_corlib。从源码编译只需:
git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore成功标志:启动游戏后,Esc 主菜单出现Mod Settings按钮。
第三步:逐项开启功能。该按钮可隐藏,也可用网页设置兜底;主开关HsMod状态关闭时插件完全不生效。
实战手册
挂机模板一键配置
- 目标:长时间离线运行,不担心掉线,上线即见奖励。
- 步骤:
- Esc 打开 Mod Settings,进入“设置模板”
- 选
AwayFromKeyboard,模板会一次性写入自动开宝箱、自动退出、关闭闲置踢线、快速拆包、屏蔽表情等一组选项 - 观察模板值自动回到
DoNothing(这是模板类选项的写入机制) - 启动前按 ReadMe.md 中
client.config示例保存登录令牌,令牌失效时游戏打不开,更新令牌即可
- 预期效果:对局结束后自动拆包领奖、自动退出不卡死;挂机期间不会因闲置被踢出。
快速拆包与批量退卡
- 目标:把几十包奖励几分钟清完。
- 步骤:
- 启用“快速拆包”
- 进入开包界面按空格,一次开五包
- 如需顺带清粉尘,手动启用“自动分解全额可退卡牌”(该选项每次启动都会重置为关闭,属于刻意设计)
- 收藏界面按 Ctrl+Z 批量退卡
- 预期效果:开包流程无需逐包点击;可退卡牌自动折算粉尘。
酒馆战棋:商店快捷键与 MMR 面板
- 目标:购物阶段少碰鼠标,看清对手实力再补牌。
- 步骤:
- 启用快捷键总开关
- 购物阶段按 R / F / U / H 执行刷新、冻结、酒馆升级、英雄技能,双人局按 T 切换队友棋盘
- 默认开启 MMR 显示与对局统计
- 赛后到
BepInEx\HsMod\bg_session.csv核对记录,网页端可查图表
- 预期效果:商店操作全程键盘完成;排名面板显示对手 MMR,CSV 记录名次、MMR 变化与英雄。
速查表:默认快捷键与关键参数
| 名称 | 快捷键 / 参数 | 作用 | 适用时机 |
|---|---|---|---|
| 升 / 降档 | 方向键 ↑ / ↓ | 调整变速倍率(-32 ~ 32,0 为正常) | 动画、结算阶段 |
| 最高速 / 复位 | 方向键 → / ← | 快速切到 8 倍并回 0 倍 | 长流程挂机前 |
| F4(固定键) | F4 | 转储对局信息、重载皮肤配置、重启 web 服务 | 改完皮肤配置 |
| 投降 / 跳过换牌 | Ctrl+空格 | 立即投降;换牌阶段直接跳过 | 战局不利时 |
| 批量退卡 | Ctrl+Z | 一键分解全额可退卡牌 | 收藏、开包界面 |
| 静音 | Ctrl+S | 一键静音炉石 | 直播、录屏 |
| 复制对手战牌 | Ctrl+C | 复制对手 BattleTag | 对局中 |
| 拆五包 | 空格 | 一次开五包 | 开包界面 |
| 商店四键 | R / F / U / H | 刷新、冻结、升级酒馆、英雄技能 | 战棋购物阶段 |
| web 端口 | 58744 | Showinfo 与/shell服务端口 | 本地查看信息 |
排错与边界
- 游戏进不去或没有 Mod Settings 按钮:先查路径是否含中文、是否误用 x86 版 BepInEx。BepInEx 5.4.23.2 起 doorstop 配置项大小写有差异,写错会导致整个框架未加载。
- 功能全部不生效:主开关
HsMod状态为关闭,或该功能本身默认关闭且你未手动开启——绝大多数功能都不默认开启。 - 打了补丁的方法不生效:同时启用了修改
Assembly-CSharp.dll的其他模组或插件,IL 偏移错位会破坏补丁,参考 Patches/ 目录可了解各补丁对应功能。 - 中国大陆客户端:炉石默认启动反作弊 SDK,插件会尝试屏蔽相关功能,但官方声明无法保证账号安全,见 ReadMe.md 顶部提示。
能力边界方面,HsMod 基于 Harmony 做运行时补丁,不改动游戏文件本身;项目遵循 AGPL-3.0,定位是学习与研究,不收集任何个人信息。界面类功能(皮肤、DbId 显示、弹窗屏蔽)只影响本地表现;模拟拆包、金币购买冒险等会触达服务器行为的功能,其风险由使用场景自行判断。
写在最后
先装好 BepInEx 5 x64 并确认 Mod Settings 按钮出现,再按场景只开你需要的几项功能。版本前两位跟着炉石大版本走,炉石更新后若插件仍可用就不必急着换新版。配置出问题,删掉BepInEx\config\下对应的.cfg重建,是最快的恢复方式。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考