HsMod：炉石传说 BepInEx 插件安装与配置完整指南

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

HsMod 是一款运行在 BepInEx 框架上的炉石传说本地插件，用于调整对战节奏、简化重复操作并支持令牌登录。它适配 Windows、macOS、Linux，内置 15 种界面语言，全部功能默认关闭，由你逐项启用。

适用人群速览

先用一句话对号入座：

核心能力拆解

四个差异化能力点，均来自 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状态关闭时插件完全不生效。

实战手册

挂机模板一键配置

• 目标：长时间离线运行，不担心掉线，上线即见奖励。
• 步骤：
  1. Esc 打开 Mod Settings，进入“设置模板”
  2. 选AwayFromKeyboard，模板会一次性写入自动开宝箱、自动退出、关闭闲置踢线、快速拆包、屏蔽表情等一组选项
  3. 观察模板值自动回到DoNothing（这是模板类选项的写入机制）
  4. 启动前按 ReadMe.md 中client.config示例保存登录令牌，令牌失效时游戏打不开，更新令牌即可
• 预期效果：对局结束后自动拆包领奖、自动退出不卡死；挂机期间不会因闲置被踢出。

快速拆包与批量退卡

• 目标：把几十包奖励几分钟清完。
• 步骤：
  1. 启用“快速拆包”
  2. 进入开包界面按空格，一次开五包
  3. 如需顺带清粉尘，手动启用“自动分解全额可退卡牌”（该选项每次启动都会重置为关闭，属于刻意设计）
  4. 收藏界面按 Ctrl+Z 批量退卡
• 预期效果：开包流程无需逐包点击；可退卡牌自动折算粉尘。

酒馆战棋：商店快捷键与 MMR 面板

• 目标：购物阶段少碰鼠标，看清对手实力再补牌。
• 步骤：
  1. 启用快捷键总开关
  2. 购物阶段按 R / F / U / H 执行刷新、冻结、酒馆升级、英雄技能，双人局按 T 切换队友棋盘
  3. 默认开启 MMR 显示与对局统计
  4. 赛后到BepInEx\HsMod\bg_session.csv核对记录，网页端可查图表
• 预期效果：商店操作全程键盘完成；排名面板显示对手 MMR，CSV 记录名次、MMR 变化与英雄。

速查表：默认快捷键与关键参数

排错与边界

• 游戏进不去或没有 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