HsMod炉石传说插件完整指南：从安装到8倍速动画、自动开包一键搞定
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是基于 BepInEx 的炉石插件，把动画提速、自动开包、领奖一锅端。50+ 开关默认全关，游戏内按Esc进Mod Settings管理，Windows、macOS、Linux 全支持。
安装前核对这 3 项前置条件
能不能装，就看下面三项，先对一遍再动手：
| 核对项 | 要求 |
|---|---|
| BepInEx 版本 | 5 系 x64 版；BepInEx 6 还是预发布、没适配，且 2026-07-01 起客户端已改为 64 位 |
| 安装路径 | 纯英文路径，不能带中文等非拉丁字符，三平台一个样 |
| 插件来源 | 直接从 Release 下载HsMod.dll，或装 .NET SDK 8.x 自行编译 |
平台路线速查：我该跳到哪一节 🧭
不用从头读到尾，找到自己的行直接跳：
| 平台 | 你的目标 | 该读哪节 |
|---|---|---|
| Windows | 挂机 / 日常省事 | 「五步完成安装」即可，启动时记得加afk=1 |
| macOS | 同 Windows | 五步 + 「macOS」小节：脚本改 3 处 + 首次传 token |
| Linux | 同 Windows | 五步 + 「Linux」小节：装好客户端后记得修换行符 |
| 任意平台 | 折腾 Web 服务、皮肤、战报 | 装完直接看「开关推荐」的外观与数据组 |
五步完成安装：从clone到Mod Settings
想自己编译（用 Release 包的可跳过）：
git clone --depth 1 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore通用五步，一步一个动作：
- 把 BepInEx x64 解压到炉石根目录。
- 建
BepInEx\unstripped_corlib\文件夹，把 HsMod/UnstrippedCorlib 下的 DLL 全部拷进去——这组 DLL 补全调试符号，BepInEx 加载插件靠它。 - 编辑根目录
doorstop_config.ini，把dll_search_path_override指到BepInEx\unstripped_corlib。 HsMod.dll放进BepInEx\plugins\。- 启动游戏按Esc，菜单里出现Mod Settings按钮，就算装好了。
Windows：只需盯住2个细节
主线平台，没有额外动作。最容易翻车的两处：
- 路径带非拉丁字符、BepInEx 装成了 x86——各查一遍。
doorstop_config.ini写法看版本：5.4.23.2 及以后是dll_search_path_override = BepInEx\unstripped_corlib，更早版本用dllSearchPathOverride（等号两侧没有空格）。
macOS：脚本改3处 + 1个登录token
- Corlib 用
UnstrippedCorlibUnix里的 DLL，拷到/Applications/Hearthstone/BepInEx/unstripped_corlib/。 - 打开
run_bepinex.sh改三处：executable_name设为Hearthstone.app；export ARCHPREFERENCE一行改成export ARCHPREFERENCE="x86_64"（客户端暂不支持 arm64）；chmod u+x run_bepinex.sh。 - 首次启动要 token：打开战网登录链接，把
http://localhost:0/?ST=之后、&accountId=之前那串截下来传给脚本，即./run_bepinex.sh TOKEN；在炉石根目录放一份client.config存住 token，之后直接./run_bepinex.sh，配合VerifyWebCredentials命令行登录，战网启动器可以长期不管。
Linux：先装客户端，再修换行符
- 先用 hearthstone-linux 项目装好客户端（它一般会替你建好
client.config），再解压 BepInEx Unix 版。 - Corlib 同样用
UnstrippedCorlibUnix，在run_bepinex.sh里设DOORSTOP_CORLIB_OVERRIDE_PATH="$BASEDIR/BepInEx/unstripped_corlib"和executable_name="Bin/Hearthstone.x86_64"。 - 修换行符：
sed -i "s/\r/ /g" ./run_bepinex.sh，接着chmod u+x run_bepinex.sh，./run_bepinex.sh启动。 - 没有
client.config的话，照 macOS 一节补 token。
开关推荐：最小可用组合先开这5个 ⚙️
别全开。所有开关默认关闭，先挑 5 个以内。
最小组合，人人可开：
- 齿轮快 8 倍速：开包、结算动画直接快进，上限在设置里可拉到 32 倍，快慢区间 -32 ~ 32。
- 快速战斗：跳过一部分动画，比齿轮更顺，开时自动屏蔽终结特效。
- 空格一键开包：一次开 5 包，可勾"开包时自动分解全额返尘的卡"。
- 弹窗批量屏蔽：匹配失败、削卡提示、广告、天梯结算与战令奖励提示一并拦掉。
- 自动领奖：竞技场、对决、佣兵结束自动点开奖励包裹，省手。
再按目标分组挑：
日常省事
- 模拟开包：自定义卡包类型、数量、稀有度，试开卡包。
- 设备模拟：模拟 iOS、Android 领专属卡背，可能要打一局匹配验证。
- 金币直购冒险：金币可直购纳克萨玛斯、黑石山、探险者协会等冒险；卡拉赞支持强开，但序章打不了。
挂机党
- 帧率显示与锁定、解除窗口焦点限制：切出去看网页，游戏不停帧。
- 禁用掉线 + 启动参数：命令行加
afk=1直接进挂机模板（插件 + 齿轮）；afk=4是反挂机。
对手情报
- 完整昵称 + 传说前天梯段位：进场先摸底，段位显示仅在传说以下生效。
- 标记对手已知卡牌：持续喂对手手牌信息，等于随身战术笔记本。
- 点击头像取酒馆昵称、对局中直接加好友：两个小功能，各顶各用。
外观与数据
- 皮肤系统：覆盖对战 / 酒馆英雄、卡背、幸运币、匹配与酒馆面板，改完
HsSkins.cfg（或在设置里改）按F4保存并模拟断线，当场生效。 - Showinfo：设置里启用后，浏览器访问
http://localhost:58744看佣兵养成进度、开包历史；启用/shell能执行命令、调配置，放云服务器记得放行 58744 端口。
炉石更新后怎么办：对比1个文件就够
HsMod 版本号是四段，例如3.0.0.0：
- 第一位：跟炉石主版本走（3 对应 26 版本）；
- 第二位：记该主版本内炉石更新次数；
- 第三位：记 HsMod 功能新增次数；
- 第四位：bug 修复编译号。
实际结论只有一条：炉石更新 ≠ 插件失效。对比更新前后的核心文件（典型是Assembly-CSharp.dll）：没变，接着用旧HsMod.dll；变了，才去拿新版本。不必每次 Release 都跟着换。
按症状排错：查表一行修好
| 症状 | 最可能原因 | 一行修复 |
|---|---|---|
| 装了没反应 | 路径含非拉丁字符，或 DLL 位置不对 | 换纯英文路径；确认HsMod.dll在BepInEx\plugins\、unstripped_corlib 完整 |
| 配置存不上 | 与其他 BepInEx 插件冲突 | 暂时只留 HsMod 再改一次 |
| 皮肤不生效 | HsSkins.cfg手改漏了引号 | 删掉HsMod.cfg重新生成，进游戏按F4 |
| Web 页面打不开 | Showinfo 没启用或端口没放行 | 检查设置开关；云服务器放行 58744 |
| 更新后功能集体失灵 | Assembly-CSharp.dll变了没换 HsMod.dll | 确认核心文件有变化，再升级HsMod.dll |
插件冲突。同时挂着别的也修改Assembly-CSharp.dll的模组（某些佣兵插件、MixMod 一类）时，补丁的 IL 偏移可能对不上，HsMod 不报错但功能不生效。最快的排除办法：把其他插件全禁掉，单独跑一遍 HsMod。
更新失灵。游戏更新后功能集体失效，九成是核心文件变了而你没换 DLL。先确认Assembly-CSharp.dll有变化，再升级HsMod.dll；文件没变就回滚到更新前的游戏目录备份，别盲目追新版本。
协议、风险与一个回滚习惯
HsMod 遵循 AGPL-3.0 协议，仅供学习研究，不收集任何用户信息。想加语言，改 HsMod/Languages/ 里的 JSON 重新编译；各功能实现都在 HsMod/Patches/ 下，顺着源码读就能改。
⚠️ 最后说重的：国服客户端默认启用反作弊 SDK，插件会尽力屏蔽相关检测，但无法 100% 保证账号安全——值不值得用，自己掂量。
留个好习惯：每次大更新前，把BepInEx\config\HsMod.cfg、HsSkins.cfg、BepInEx\HsMatch.log各拷一份，出问题秒回滚，比什么都省事。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
