HsMod炉石传说插件完整安装指南：8倍速开包、自动领奖、对手段位实时显示-开发者社区

HsMod炉石传说插件完整安装指南：8倍速开包、自动领奖、对手段位实时显示

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

HsMod 是一款基于 BepInEx 的免费开源炉石传说插件，面向想加速开包、屏蔽弹窗、查看对手段位信息的普通玩家。装好之后，你能在游戏内直接获得 8 倍速动画、自动领奖、对手完整昵称与皮肤定制能力。

能力速览：HsMod 能替你做什么

能力	具体收益	适合谁
齿轮变速 8 倍速，配置上限 32 倍速	开包动画、回合等待几乎归零	存包多、局数多的玩家
实时 FPS 显示与帧率锁定	帧率稳定，告别忽高忽低	中低配置电脑用户
移除窗口焦点与缩放限制	切到别的窗口看攻略不假死	边打边查攻略的人
对手完整战网昵称 + 传说以下天梯等级	段位一眼看清，可加好友、复制标签	天梯冲分玩家
弹窗屏蔽（无法匹配、削卡公告、广告、结算提示）	思路不被打断	容易被弹窗带节奏的人
空格键一次开 5 包 + 自动分解全额返尘卡	百包几分钟开完	攒包党、挂机玩家
皮肤与卡背定制（英雄皮肤、酒馆面板、卡背）	界面外观可深度改造	外观党
酒馆战棋 MMR 显示与 CSV 对局记录	对手隐藏分可见，分差可画图表	酒馆冲分玩家

动手前：系统要求与安全边界

先看硬性条件：BepInEx 只能用 5.x 的 x64 版本（2026 年 7 月炉石已转为 64 位程序，BepInEx 6 仍是预览版，未适配）；想自己编译需要 .NET SDK 8.x；Windows、macOS、Linux 三个平台均支持。

炉石安装路径必须全部为英文字母等拉丁字符，不能包含中文——这是安装阶段失败率最高的原因，先检查路径再动手。

账号安全方面：中国大陆客户端默认会启动反作弊 SDK，HsMod 会尝试屏蔽相关反作弊功能，但无法保证账号百分之百安全。另外，HsMod 若与其他修改Assembly-CSharp.dll的炉石插件或别的 BepInEx 插件同时使用，可能出现补丁冲突、功能失效，建议单独使用。

Windows 安装步骤

Windows 主路径一共五步：取插件、装 BepInEx、补齐游戏库、改一行配置、重启游戏。

1. 获取HsMod.dll。从官方 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。

2. 解压 BepInEx：下载 BepInEx 5.x 的 x64 版本，解压到炉石安装根目录（Hearthstone\）。

3. 补齐游戏库文件：新建Hearthstone\BepInEx\unstripped_corlib\，把 HsMod/UnstrippedCorlib 目录下的全部 DLL 复制进去。

这一步决定插件能否正确引用游戏内部库，DLL 缺一个都可能导致加载失败，是整个安装里最容易出错的环节。

4. 修改配置：编辑炉石根目录的doorstop_config.ini，将dll_search_path_override的值改为BepInEx\unstripped_corlib（BepInEx 5.4.23.2 及以上版本；更早版本用键名dllSearchPathOverride）。

5. 放入插件启动：把HsMod.dll放进Hearthstone\BepInEx\plugins，启动游戏。进游戏后按Esc打开菜单，点Mod Settings进入配置面板，绝大多数功能默认关闭，需要手动勾选。

macOS 与 Linux 安装（压缩版）

macOS：解压 BepInEx 5.x 的 macos_universal 版到Hearthstone/，把 HsMod/UnstrippedCorlibUnix 的 DLL 复制到BepInEx/unstripped_corlib/；在run_bepinex.sh中设置dll_search_path_override="BepInEx/unstripped_corlib"、executable_name="Hearthstone.app"，并把ARCHPREFERENCE改为x86_64（炉石目前不是 arm64 原生程序），执行chmod u+x run_bepinex.sh，再配合从战网登录地址获取的令牌启动。

Linux：先用 hearthstone-linux 项目装好炉石，解压 BepInEx unix 5.x 版到炉石根目录，unstripped_corlib同样使用UnstrippedCorlibUnix的 DLL；run_bepinex.sh中设executable_name="Bin/Hearthstone.x86_64"，用sed -i "s/\r/ /g"修正换行符后直接运行即可。

功能拆解：效率、信息、自动化三个阶段

所有开关都在Mod Settings里，按下面三个阶段依次开启，比一次性全开更容易排查问题。

阶段一：效率提升——变速与帧率怎么开

怎么开启：在 Mod Settings 中打开齿轮变速、帧率显示、窗口限制解除相关开关。开启后能做什么：变速直接到 8 倍速，不够用可在配置里拉到 32 倍速上限；屏幕实时显示 FPS，也可手动锁定或调整帧率上限；窗口不再因失焦卡死，大小可自由拉伸。推荐初始设置：先开 8 倍速 + FPS 显示；电脑配置一般的话，再锁一个稳定帧率，比默认表现更流畅。

阶段二：信息增强——对手段位与昵称怎么显示

怎么开启：在 Mod Settings 中开启对手信息类开关。开启后能做什么：显示对手完整战网昵称，匹配界面可一键加好友、复制战网标签；传说段位以下直接显示对方天梯等级，并标记对手已打出的已知卡牌，方便推算手牌；酒馆战棋排行榜悬浮层直接显示对手 MMR，每场名次、隐藏分变化、英雄记录写入 CSV 并绘制图表，可按今天 / 7 天 / 月 / 全部以及单双排筛选，日志文件为BepInEx\HsMatch.log。推荐初始设置：昵称 + 等级显示常开；打酒馆冲分时再打开 CSV 记录。

阶段三：个性化与自动化——开包领奖怎么自动

怎么开启：打开自动化类别开关，并在设置里为需要的功能绑定快捷键。开启后能做什么：按空格一次开 5 包，开包时自动分解全额返尘的重复卡；竞技场、对决、佣兵的奖励到结算环节自动领取并拆开奖励包；禁用掉线机制，长时间挂机不被踢；配合命令行参数或client.config可免开战网客户端直接登录；表情冷却缩到最短 1.5 秒，支持快捷键发送；屏蔽对手表情与思考表情、静音鲍勃语音、跳过英雄介绍。外观方面，英雄皮肤、最终效果、匹配面板、酒馆面板、幸运币、卡背都可在设置里改，或直接编辑Hearthstone\BepInEx\config\HsSkins.cfg；对局中改完按F4保存并模拟断线重连即生效，还支持卡牌自动变金/变钻、佣兵随机皮肤。推荐初始设置：先只开自动领奖；开包自动化在存包较多时再开；挂机需求才开启禁用掉线。

数据与进阶：Web 页面、开发者模式、快捷键管理

这三类功能日常用不上，按使用场景来查。

想在浏览器里看数据时：HsMod 内置 Web 服务，默认监听 58744 端口，启动后访问本地地址可查看佣兵养成进度、开包历史等信息；用云服务器需先在防火墙与安全组放行该端口。设置里还可手动开启/shell路径的 Webshell，用于远程执行命令与调整配置（中文输出可能乱码）。
想研究游戏内部时：插件保留了进入炉石开发者模式的入口，还能模拟开包（自定义类型、数量、稀有度）、模拟断线重连、用金币购买纳克萨玛斯等冒险模式。
想改键位时：F4是固定功能键，用于导出游戏信息（存到Hearthstone\BepInEx\）、更新皮肤配置、重启 Web 服务，不可更改；其余快捷键都可在设置中自由绑定，建议先熟悉默认键位再动手。

Web 端的源码与页面资源见 HsMod/WebResources/ 与 HsMod/WebApi.cs；多语言文件在 HsMod/Languages/，改 JSON 重新编译即可换翻译。

故障排查：现象、原因、解决办法

九成装不生效的问题都能在下表中定位。

现象	可能原因	解决办法
装完功能没反应	BepInEx 解压不完整、`unstripped_corlib`的 DLL 不全、`HsMod.dll`不在`plugins`目录	逐项核对目录结构，再看游戏启动日志确认插件是否加载
设置保存不上	与其他炉石插件冲突	先停用其他插件，或删除`BepInEx\config\`下对应配置文件后重新配置
皮肤显示异常	`HsSkins.cfg`格式错误	检查配置内容，必要时删除`HsMod.cfg`让其重新生成默认配置
Web 服务连不上	58744 端口被防火墙拦截，或功能未开启	检查防火墙/安全组与设置中的功能开关，再看日志确认服务状态