HsMod 炉石传说加速插件：8 倍速动画、空格开包与 50+ 功能开关
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一个跑在 BepInEx 框架上的炉石传说插件，把动画提速、开包、领奖、皮肤、战报这些高频动作压进一个插件里，50 多项开关全部默认关闭，按需在菜单里勾选即可，游戏内按Esc找到Mod Settings就能管理全部设置。
先定路线：你的平台和目标决定走哪条路
| 平台 | 你的目标 | 该走哪条路 |
|---|---|---|
| Windows | 挂机 / 日常省事 | 主线最短，装完挑提速和自动化开关，启动加afk=1 |
| macOS | 同 Windows | 主线 +run_bepinex.sh三处修改 |
| Linux | 同 Windows | 主线 + 启动脚本修复 + 启动参数 |
| 任意平台 | 折腾 Web 服务、皮肤、战报 | 装完再进 Showinfo 与皮肤配置 |
装 HsMod 之前：前置条件与三平台通用步骤
前置条件一张表说清：
| 条件 | 要求 |
|---|---|
| BepInEx | 5 系 x64 版（BepInEx 6 仍是预发布，未适配；2026-07-01 起客户端为 64 位） |
| 安装路径 | 不能包含中文等非拉丁字符，三平台通用 |
| 插件本体 | 从 Release 下载HsMod.dll，或装 .NET SDK 8.x 自行编译 |
通用五步，代码块里就是 Windows 下的全部命令行操作：
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 差异：路径与 BepInEx 版本
主线平台，没有额外动作。最容易翻车的是路径里有非拉丁字符、BepInEx 装成了 x86，这两处各查一遍。doorstop_config.ini在炉石根目录，BepInEx 5.4.23.2 及以后写法为dll_search_path_override = BepInEx\unstripped_corlib，更早版本用dllSearchPathOverride（等号两侧没有空格）。
macOS 差异：脚本三处修改加一个 token
用HsMod/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 版。unstripped 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启动。没有client.config就照 macOS 一节补 token。
更新后怎么判断插件还要不要动
HsMod 版本号是四段，例如3.0.0.0：第一位跟炉石主版本（3 对应 26 版本），第二位记该主版本内炉石更新次数，第三位记 HsMod 功能新增次数，第四位是 bug 修复编译号。实际结论只有一条：炉石更新 ≠ 插件失效。对比更新前后的核心文件（典型是Assembly-CSharp.dll），没变就接着用，变了才去拿新的HsMod.dll，不必每次 Release 都跟着换。
按要解决的问题挑功能
先别全开，绝大多数开关默认关闭，挑 5 个以内就够。
提速类
- 齿轮快 8 倍速：开包、结算动画直接快进，上限在设置里可以拉到 32 倍（快慢 -32 ~ 32）。
- 快速战斗：跳过一部分动画，比齿轮更顺，开时自动屏蔽终结特效。
- 帧率显示与锁定、解除窗口焦点限制：切出去看网页游戏不停帧。
自动省事类
- 空格一键开包：一次开 5 包，可勾开包时自动分解全额返尘的卡。
- 自动领奖：竞技场、对决、佣兵结束自动点开奖励包裹。
- 弹窗批量屏蔽：匹配失败、削卡提示、广告、天梯结算与战令奖励提示一并拦掉。
- 禁用掉线 + 启动参数：命令行加
afk=1直接进挂机模板（插件 + 齿轮），afk=4是反挂机。
对手情报类
- 完整昵称 + 传说前天梯段位：进场先摸底，段位显示在传说以下才生效。
- 标记对手已知卡牌：持续给你喂对手手牌信息，相当于随身战术笔记本。
- 点击头像取酒馆昵称、对局中直接加好友。
外观与数据类
- 皮肤系统：对战 / 酒馆英雄、卡背、幸运币、匹配与酒馆面板等，改完
HsSkins.cfg（或在设置里改）按F4保存并模拟断线当场生效。 - Showinfo：设置里启用后浏览器访问
http://localhost:58744，看佣兵养成进度、开包历史；启用/shell可执行命令、调配置，放云服务器记得开 58744 端口。 - 模拟开包 / 设备模拟 / 金币直购冒险：前者自定义卡包类型、数量、稀有度，后者模拟 iOS、Android 领专属卡背（可能要打一局匹配），金币可直购纳克萨玛斯、黑石山、探险者协会等冒险，卡拉赞支持强开但序章打不了。
排错表：症状、最可能原因、一行修复
| 症状 | 最可能原因 | 一行修复 |
|---|---|---|
| 装了没反应 | 路径含非拉丁字符，或 DLL 位置不对 | 换纯英文路径；确认HsMod.dll在BepInEx\plugins\、unstripped_corlib 完整 |
| 配置存不上 | 其他 BepInEx 插件冲突 | 暂时只留 HsMod 再改一次 |
| 皮肤不生效 | HsSkins.cfg手改漏了引号 | 删掉HsMod.cfg重新生成，进游戏按F4 |
| Web 页面打不开 | Showinfo 没启用或端口没放行 | 检查设置开关；云服务器放行 58744 |
两个值得多说的点。
插件冲突。同时挂着其他修改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），仅供参考
