炉石传说玩得心累？HsMod 插件实战手册，帮你把等待和重复操作砍掉一大半

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

花十几秒等动画转完、机械地一包一包开卡、被毫无信息量的弹窗反复打断——这些"慢"和"累"，几乎每个炉石传说玩家都经历过。如果你正在找一款能真正改变这种体验的炉石传说插件，基于 BepInEx 框架开发的开源项目 HsMod 值得你花十分钟读完这篇指南。它面向普通玩家：不需要你会写代码，装上之后，对战加速、自动开包、弹窗屏蔽、皮肤自定义等功能，都可以在游戏内的设置菜单里直接开启。下文不按功能清单硬背，而是从玩家最常遇到的六个问题出发，逐条给出对应的解法。

装不上、进不去：环境搭建的三个高频坑

问题：明明把插件和 BepInEx 都放好了，进游戏却毫无反应，或者干脆黑屏。

解法：九成问题出在下面三处，逐一核对即可。

1. 安装路径不能有中文。炉石本身的安装目录以及插件所在路径都不能包含非拉丁字符，这是很多玩家忽略的第一道坎。
2. BepInEx 必须用 5.x 的 x64 版本。炉石客户端自 2026 年 7 月起已变为 64 位程序，BepInEx 6 目前仍是预览版、尚未适配，别选错。
3. 三件套要配齐：把项目里HsMod/UnstrippedCorlib目录下的所有 DLL 复制到Hearthstone\BepInEx\unstripped_corlib\；然后在doorstop_config.ini中设置dll_search_path_override = BepInEx\unstripped_corlib；最后把编译好的HsMod.dll放进Hearthstone\BepInEx\plugins。

效果预期：正确加载后，进入游戏按Esc或点击齿轮图标，菜单里会出现"Mod Settings"入口，所有开关都在这里。

不会编译也能用：一条命令链搞定

如果你只想要现成的 DLL，可以直接使用仓库发布页提供的编译产物；想自己动手，也很简单，需要提前装好 .NET SDK 8.x：

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。项目里还附带了install.bat，如果你已经配好 BepInEx，运行它就能把 DLL 自动复制到炉石目录。

Mac 和 Linux 用户差在哪

跨平台的配置逻辑一致，只有几个关键差异：需要下载 BepInEx 的 Unix 版本，把HsMod/UnstrippedCorlibUnix里的 DLL 拷入unstripped_corlib；编辑run_bepinex.sh，将dll_search_path_override指向正确路径，并把executable_name改为对应的启动文件名（Linux 下通常是Bin/Hearthstone.x86_64）；最后执行chmod u+x run_bepinex.sh再运行脚本。如果你不想每次启动都经过战网，还可以通过登录链接获取 token 写入client.config，之后就能直接启动游戏。

对局太拖沓：把速度、帧率和窗口一次性调顺

问题：动画慢吞吞、帧率忽高忽低、切个窗口游戏就失去响应。

解法：这是 HsMod 最受欢迎的一类功能，全部在设置里点选即可。

• 速度调节⚡：游戏内齿轮的倍率上限从官方默认值提升到 8 倍，配置里还能进一步调到 32 倍，并且支持绑定快捷键随时切换。刷日常、清任务、开包时，动画几乎可以瞬间跳过。
• 帧率管理：在界面上实时显示当前帧率，并自定义游戏目标帧率。低配设备建议主动锁帧，换来更稳定的画面和更低的发热。
• 窗口自由：移除"必须保持焦点"的限制，切出去看网页、回消息不再打断游戏；同时解除窗口尺寸限制，多开或边玩边看视频都很方便。

酒馆战棋专场更值得一试：排行榜界面直接显示对手的 MMR；对局结束后自动生成会话统计（CSV 日志 + 今日 / 7 天 / 月度图表，可区分单人和双人模式）；购物阶段可以绑定刷新、冻结、升级酒馆、英雄技能、查看队友棋盘等快捷键；开局自动静音全场表情、跳过英雄登场动画，连战斗动画都能部分跳过。整套下来，一局酒馆的时间能明显缩短。

弹窗、广告、表情太吵：把噪音一键关停

问题：好不容易进入状态，弹窗一个接一个，对面还疯狂发表情。

解法：插件把"噪音源"分成了几类，可以分别处理。

• 弹窗类：无法匹配提示、削卡补丁通知、广告推销、天梯结算奖励、对局结束推广、任务与成就奖励弹窗，都可以按需屏蔽，让界面清爽很多。
• 表情类：屏蔽对手表情或设置表情接收上限、屏蔽"思考中"表情、屏蔽酒馆鲍勃的语音。反过来，如果你想"反击"，也可以开启无冷却表情（最小间隔 1.5 秒）并绑定快捷键一键发送。
• 其他噪音：屏蔽向暴雪发送错误报告、一键移除收藏里的"new!"标记，还能用内置的挂机模板一次性套用一组推荐设置，免去逐个开关的麻烦。

开包、领奖、分解太累：把这些交给自动化

问题：攒了一堆卡包，开包点到手酸；竞技场奖励、分解粉尘也要手动操作。

解法：HsMod 把最机械的几类重复劳动都做成了自动化选项。

• 快速开包：按一下空格直接开 5 包；还可以开启"自动分解已全额返还的卡牌"，开完包粉尘自动到账。
• 自动领奖：竞技场、对决、佣兵等模式结束后，自动领取奖励包，不用再盯着结算界面。
• 防挂机：关闭空闲踢出机制，长时间挂着不被强制下线；需要刷新状态时，还能用快捷键模拟断线重连。
• 快速重开：0-0 战绩、无卡组时可以直接放弃对局，适合速刷模式。
• 自动举报：检测到对手疑似不当行为时自动生成举报记录；配合观战功能，还能自动轮换卡组、观战时自动切换双方视角。

界面千篇一律：皮肤与信息增强

问题：皮肤看腻了，而且对局里能看到的对手信息太少。

解法：外观定制和信息增强是 HsMod 的另一大看点。

• 皮肤修改：配置文件位于Hearthstone\BepInEx\config\HsSkins.cfg，可以修改匹配与酒馆的英雄皮肤、终结特效、匹配面板、酒馆面板、幸运币、鲍勃外观以及卡背。在游戏中修改后按F4保存并模拟一次重连即可生效。
• 卡牌效果：强制金卡或钻石卡、佣兵随机皮肤，也可以单独屏蔽对手的卡牌特效，避免干扰判断。
• 信息增强：显示对手完整战网昵称、匹配中直接添加对手、显示对手天梯等级（传说段位之前）、标记对手已用过的卡牌来推测手牌构成、收藏界面显示 9 张以上的真实数量、右键卡牌显示 DbId，方便查阅资料。

进阶玩法：Web 面板、开发者模式与模拟功能

如果你愿意多花一点时间研究，HsMod 还藏着一套偏"硬核"的能力：

• Web 面板：内置 HTTP 服务默认监听 58744 端口，浏览器打开即可查看佣兵养成进度、开包历史等数据；Web 界面模板源码在HsMod/WebResources/目录下，样式可以自行调整。注意：云服务器上使用时要放行该端口的防火墙规则。
• Webshell：路径为/shell，需在设置中显式开启，适合做进阶调试。
• 开发者模式：可以进入炉石的开发者模式探索内部机制。
• 模拟功能：模拟开包（自定义类型、数量、稀有度与品质）、模拟设备以收集各平台卡背、用金币直接购买冒险模式（纳克萨玛斯、黑石山、探险者协会；卡拉赞可开放但序章无法游玩）。
• F4 快捷键：转储部分游戏信息、更新皮肤配置并重启 Web 服务。除 F4 外，其余快捷键都可以在设置里自定义。

默认设置对照表：哪些该开，哪些先别动

需要特别说明的是，HsMod 的绝大多数功能默认都是关闭的，这样不会影响原版体验。下面这张表可以帮你快速决策：

用之前必须知道的合规与稳定性事项

最后这部分很重要，请务必读完。

• 账号安全无法保证。中国大陆的炉石客户端默认会启动反作弊 SDK，插件会尝试屏蔽相关检测，但不能保证账号绝对安全，请合理使用、自行评估风险。
• 存在冲突可能。与直接修改Assembly-CSharp.dll的插件可能互不兼容；多个 BepInEx 插件同时 patch 同一个方法时也可能出问题。
• 排障三板斧。功能异常时，先删除BepInEx\config\下对应的.cfg文件让插件重新生成默认配置，仍不行再考虑删除HsMod.cfg；HsMod.cfg、HsSkins.cfg、HsMatch.log这几个重要文件建议定期备份。
• 理解版本号。HsMod 采用四段式版本号：第一段对应炉石主版本，第二段是炉石在该版本内的更新次数，第三段是 HsMod 新增功能的次数，第四段是修复次数。炉石的小更新不一定让插件失效，功能正常时不必急于升级。
• 多语言支持。界面支持多语言，翻译文件位于HsMod/Languages/，如果你发现翻译不准确，可以直接修改对应 JSON 并重新编译，贡献一份自己的本地化。

现在就可以动手了

从 clone 代码、编译 DLL，到放进plugins目录、进游戏打开 Mod Settings，整个过程通常只需要几分钟。这个项目遵循 AGPL-3.0 开源协议，仅用于学习与研究，且不收集任何用户信息；对源码感兴趣的话，HsMod/Patches/目录下的补丁代码就是很好的入门教材。

最后再提醒一句：插件的初衷是让游戏更顺手、更高效，请在遵守游戏规则的前提下使用，不要利用它干扰其他玩家的正常体验。希望这份实战手册能帮你把炉石传说玩得更轻松、更尽兴。

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