炉石变速插件 HsMod 完整指南：3 步装好，变速、开包、战棋统计一次配齐
炉石变速插件 HsMod 完整指南：3 步装好，变速、开包、战棋统计一次配齐
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一个基于 BepInEx 的免费开源炉石插件，把游戏内变速、自动开包、弹窗屏蔽、对手段位与 MMR 显示、酒馆战棋战绩统计这些需求整合在一个配置菜单里。本文从装环境到按目标开关功能，一次讲清，装完当小时速就能拉满。
开局那个卡住你的地方
你攒了一周的卡包，点"全部打开"，然后盯着一张张翻牌动画，干等十几分钟；打酒馆战棋时对面 MMR 高得离谱却完全看不出来，只能被翻盘后自己琢磨；天梯结算完还弹一堆广告和削卡公告，关都关不完。
这三件事分别对应 HsMod 里最实用的三块能力：时间变速（动画直接快进，最高 32 倍速，配置上限可调）、对手信息增强（完整战网昵称、传说以下的天梯等级、战棋隐藏分 MMR 直接挂在排行榜上）、自动化（空格一次连开 5 包、奖励自动领取）。功能几乎默认全关，装好后按 Esc 进游戏菜单找Mod Settings，想开哪个勾哪个。
它到底能干什么：一张表看全
| 分类 | 具体能力 |
|---|---|
| 变速与节奏 | 快/慢时间档位，最高 8 倍速一键切换（配置上限 32 倍）；帧率显示、手动锁帧 |
| 对手信息 | 完整战网昵称 + 加好友；传说以下显示天梯等级；标记对手已打出的牌；战棋排行榜显示 MMR |
| 自动化 | 空格连开 5 包（可自动分解全额返尘的重复卡）；竞技场/对决/佣兵奖励自动领取并拆包；屏蔽断线以长时间挂机；自动举报对手 |
| 界面清爽 | 屏蔽削卡公告、广告、天梯结算弹窗、匹配失败提示；解除失焦卡死和窗口拉伸限制 |
| 战棋专属 | 商店刷新/冻结/升级酒馆/英雄技能/队友棋盘全套快捷键（仅购物阶段生效）；每场名次与分差写入 CSV 并出图表（今天/7天/月/全部，单双排可筛）；开局自动屏蔽全场表情 |
| 表情互动 | 屏蔽对手表情、思考表情、鲍勃语音；表情冷却最短压到 1.5 秒；快捷键发表情 |
| 皮肤外观 | 英雄皮肤、卡背、酒馆面板、幸运币等可换（HsSkins.cfg或游戏内直接改）；佣兵随机皮肤 |
| 数据与开发 | 本地 Web 页（默认 58744 端口）看佣兵养成、开包历史；模拟开包自定义数量稀有度；模拟断线重连；进入炉石开发者模式 |
源码按功能拆在 Patches/ 目录下，每个PatchXxx.cs对应一类能力，比如 PatchFakePackOpening.cs 管模拟开包、PatchBgRank.cs 管战棋排行信息，想搞清楚某个功能怎么实现的可以直接看对应文件。
装好它：两条路径，挑一条
路径 A：直接拿现成的 HsMod.dll（推荐新手）
从项目 Release 下载HsMod.dll即可，不用编译。
路径 B：自己编译（想改代码再看）
需要 .NET SDK 8.x，两条命令搞定，产物在HsMod/Release下的HsMod.dll：
git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod && dotnet build --configuration Release --no-restoreWindows 部署：4 步走完（约 5 分钟）
- 解压 BepInEx：选5 系 x64版解压到炉石安装根目录。炉石 2026 年 7 月起转为 64 位程序，BepInEx 6 还是预览版没适配，别走偏。
- 补齐运行库：新建
Hearthstone\BepInEx\unstripped_corlib\，把项目里 UnstrippedCorlib/ 目录的全部 DLL 复制进去。这步决定插件能否正确引用游戏内部库，是最容易漏的一步。 - 改一处配置：编辑炉石根目录的
doorstop_config.ini，把dll_search_path_override的值设为BepInEx\unstripped_corlib，加载器才会先找到这些库。 - 放入插件并启动：
HsMod.dll丢进Hearthstone\BepInEx\plugins\，双击启动游戏。
⚠️ 炉石安装路径不能包含中文或其他非拉丁字符，否则插件可能直接加载失败。动手之前先把安装路径检查一遍，这是安装阶段唯一的硬坑。
📌
dll_search_path_override指向哪，DoorStop 就在哪找库文件。官方 README 明确要求指向unstripped_corlib而不是BepInEx根目录。
macOS / Linux：一张表对照
| 平台 | BepInEx | 库文件来源 | 启动脚本要点 |
|---|---|---|---|
| macOS | 5 系 macos_universal | UnstrippedCorlibUnix/ | run_bepinex.sh里executable_name改Hearthstone.app，ARCHPREFERENCE设为x86_64（炉石还不是 arm64 原生），最后chmod u+x run_bepinex.sh，用登录令牌启动 |
| Linux | 5 系 Unix 版 | UnstrippedCorlibUnix/ | 先用 hearthstone-linux 项目装好炉石；脚本里executable_name写Bin/Hearthstone.x86_64，sed -i "s/\r/ /g"修正换行符后照常启动 |
macOS/Linux 下令牌（token）从战网登录 URL 里截取http://localhost:0/?ST=之后、&accountId=之前的部分，写进炉石 exe 旁的client.config就能免战网客户端启动，格式见 ReadMe.md 的 client.config 一节。
按你想达成的目标来开功能
功能默认全关，别一口气全勾，按目标分批开，出问题也好定位。
想让对局变快
操作：Mod Settings 里开时间变速，对局中按档位快捷键切换；嫌卡的话顺手把帧率显示打开、手动锁帧。
立刻能看到什么：换牌阶段按空格跳过动画直接进局；动画档位拉到 8 倍，回合等待、开包动画肉眼可见地变快。
哪里容易翻车：时间档位是快捷键切换的，先记住默认键位再谈改键；帧率上限调太高反而不如锁个稳定值，配置一般的电脑求稳不求高。
想看清对手
操作：开启"对手段位与昵称显示"和"标记对手已知卡牌"。
立刻能看到什么：对面昵称旁出现完整战网昵称（可加好友、复制标签），传说以下直接标出天梯等级；对手打过的牌被标记，方便推算他手里还剩什么。
哪里容易翻车：战棋里 MMR 是开局后台加载的，前几秒排行榜上可能还是空的，属正常现象，加载模块见 BgRankOverlay.cs。
想让重复操作替你点
操作：开"快速开包"（空格一次 5 包）+ "自动分解全额返尘卡"，再开竞技场/对决/佣兵的"自动领奖"。
立刻能看到什么：攒了几十个包，几分钟清完；竞技场打完奖励直接自动拆，手不用动。
哪里容易翻车：自动分解只对全额返尘的卡生效，稀有重复卡不会被动；佣兵场景下自动领奖偶有兼容问题（官方 Roadmap 里还在修），发现没领到就先手动补一次。
战棋玩家专属：把信息差补满
操作：开启 MMR 显示、商店快捷键（刷新/冻结/升级/英雄技能）、开局自动屏蔽对手表情（默认关）。
立刻能看到什么：排行榜上每个玩家名字下挂 MMR；购物阶段按快捷键秒刷新秒升级，不再点半天鼠标。每场名次、分差、英雄自动追加进 CSV（BgSessionStats.cs 负责写入和对账），设置菜单的战绩页有图表，支持今天 / 7 天 / 月 / 全部和单双排筛选。
哪里容易翻车：MMR 对账机制会把"末回合崩溃丢记录、换设备打分"这类漏掉的增减补成 Synced 记录，看到这种记录不用慌，它就是为了保证统计和实际分数一直对得上。
进阶：本地 Web 页和 F4
Web 数据页：内置服务默认监听58744端口，游戏启动后浏览器打开本机对应地址，佣兵养成进度、开包历史都在里面。设置里还能手动开启/shell路径的 Webshell 命令执行，用来远程调配置。
🔒 云服务器记得在防火墙和安全组放行 58744，否则外部访问不到；Webshell 建议只在内网用，公网暴露一个命令执行口太危险。
模拟与开发者模式：模拟开包可以自定义类型、数量、稀有度，适合研究卡牌实现；还能模拟断线重连、用金币买纳克萨玛斯等冒险、进炉石开发者模式（入口见 PatchDevOptioins.cs）。
F4是插件的固定功能键，管三件事：导出游戏信息、更新皮肤配置、重启 Web 服务，不能改绑。皮肤对局中改完按 F4 保存，再模拟一次断线重连，新外观立即生效。
装对了吗：3 分钟自检
- 插件没反应：依次确认 BepInEx 装完整、
unstripped_corlib里 DLL 齐全、HsMod.dll在plugins目录，最后翻启动日志里的加载记录。 - 设置存不上：先停用其他炉石插件排除冲突（HsMod 可能与改
Assembly-CSharp.dll的 mod 冲突，IL 偏移错位后补丁会失效），再删掉BepInEx\config\下的相关配置让它重新生成。 - 皮肤显示异常：检查
HsSkins.cfg（首次运行自动生成，位于Hearthstone\BepInEx\config\）格式，必要时删掉HsMod.cfg重新配置。 - Web 页打不开：确认 58744 没被防火墙拦、功能确实开了，再看日志里的服务状态。
版本号是四段式：第一位对应炉石主版本，第二位是版本内更新次数，第三位是新增功能次数，第四位是编译号（主要记 bug 修复）。炉石更新后只要Assembly-CSharp.dll这类核心文件没变、插件还能跑，就不必急着追新版。
几句实话
- 账号安全：大陆客户端默认启用反作弊 SDK，HsMod 会尝试屏蔽相关功能（PatchAntiCheat.cs），但官方明确说无法百分百保证账号安全。原则是只开影响自己体验的——变速、皮肤、信息展示类，别去干扰别人的对局。
- 协议与隐私：项目遵循 AGPL-3.0，不收集任何数据。
- 多语言：界面文案在 Languages/ 下有简中、繁中、英、日、韩等 JSON 文件，改完重新编译即可生效；插件翻译尚未完全覆盖所有语言。
合上文章就能做的三步
- 按 Windows 四步把 BepInEx +
unstripped_corlib+HsMod.dll铺好，启动后按 Esc 确认能看到Mod Settings按钮——看到它就算装对了； - 只开三个开关：时间变速、失焦/窗口限制解除、弹窗屏蔽，跑一局找节奏；
- 顺手再开自动开包和自动领奖把攒包交给插件，稳定一周后，再去动 Web 页、开发者模式和战棋 CSV 这些进阶项。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考