炉石传说插件 HsMod 免费开源指南：60 多项实用功能，从安装到进阶一次讲透

炉石传说插件 HsMod 免费开源指南：60 多项实用功能，从安装到进阶一次讲透

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

先讲一个炉石玩家的"崩溃瞬间"

凌晨一点，你终于凑齐了竞技场 12 胜的钥匙，却要一包包手动点开奖励；酒馆战棋开局，对面一个"打得不错"刷屏刷到你想关游戏；明明设置了 1080P，切出去回个消息，回来就发现游戏被强制弹到窗口……这些画面是不是很熟悉？

如果你也在找一款炉石传说插件来解决这些零零碎碎的小烦恼，那今天要介绍的 HsMod 很可能是你的菜。它是一款基于 BepInEx 框架的开源免费插件，不碰账号数据、不联网上传任何信息，安装好后能一口气解锁 60 多项实用功能——从战棋段位显示到一键开包，从皮肤自由换到自动化挂机，基本覆盖了你能想到的"体验优化"。

它到底是个什么项目？适合谁用？

一句话定位：HsMod 是一个运行在炉石客户端里的功能增强插件，通过 BepInEx 注入技术为游戏扩展新能力，代码完全开源（遵循 AGPL-3.0 协议），主要用于学习和研究。

它适合这几类人：

• 🎮休闲玩家：想屏蔽表情骚扰、跳过冗长动画、开包更顺手；
• ⚔️战棋玩家：想要对手 MMR 显示、对局统计图表、商店快捷键；
• 🧪收集党：想自定义皮肤、卡背、镀金卡牌，甚至解锁隐藏外观；
• 🤖挂机党：想自动领奖励、自动分解全额返尘卡牌、无人值守长时间在线；
• 🔧开发者：想研究 Unity 游戏插件开发，或基于它二次开发。

顺带一提，插件本身很"低调"：它默认几乎不启用任何功能，需要你手动在设置里开关，避免误触。

新手篇：十分钟，从零到能跑

以 Windows 为例，整个安装过程其实就是"放文件 + 改一行配置"。

第一步：准备 BepInEx 环境

炉石客户端在 2026 年 7 月之后已全面转为 64 位，所以请务必下载BepInEx 5 的 x64 版本（BepInEx 6 还在预发布阶段，暂不支持），解压到炉石安装根目录。

第二步：补齐解包库文件

把项目里HsMod/UnstrippedCorlib目录下的所有 dll 文件，复制到Hearthstone\BepInEx\unstripped_corlib\这个文件夹。

第三步：修改 doorstop 配置

编辑炉石根目录下的doorstop_config.ini，加上一行：

dll_search_path_override = BepInEx\unstripped_corlib

第四步：放入插件本体

将编译好的HsMod.dll丢进Hearthstone\BepInEx\plugins，然后正常启动游戏。

第五步：打开设置面板

进入游戏后按Esc，你会看到菜单里多了一个Mod Settings按钮，点进去就能开始逐项开关功能。

macOS 和 Linux 也有对应的安装路径（分别使用UnstrippedCorlibUnix目录和对应的启动脚本），核心逻辑一致，照着项目文档操作即可。

💡 想要自己编译？项目基于 .NET SDK 8，执行git clone https://gitcode.com/GitHub_Trending/hs/HsMod后运行dotnet build --configuration Release --no-restore，产物就是HsMod.dll。

核心能力总览：六大门类，一次看全

⚡ 战棋增强：从"瞎打"到"心里有数"

• 对手 MMR 实时显示：开局后在排行榜上直接标注每位对手的隐藏分，单人和双人都支持，数据在后台预加载，不拖慢开局；
• 对局统计图表：每一场排位都会记录名次、MMR 变化和英雄，自动写入 CSV 日志（默认BepInEx\HsMatch.log），并提供按天/周/月/全部、单双排筛选的统计页；
• 商店快捷键：刷新、冻结、升酒馆、英雄技能、双排队友面板，全部可自定义按键，只在购物阶段生效；
• 自动静音对手：开局自动屏蔽所有人表情，清净一整局（默认关闭，需要手动开）；
• 极速战斗：跳过部分战斗动画，结算更丝滑，连终结技施放也能略过。

✨ 界面与手感优化

• 8 倍速齿轮：游戏自带变速只有 2 倍，HsMod 直接拉到 8 倍，配置里还能放宽到 32 倍；
• 帧率显示与锁定：实时查看 FPS，还能自己指定目标帧率；
• 弹窗清理工：屏蔽"无法匹配"、补丁公告、广告、天梯结算弹窗等各类提示；
• 收藏便利贴：右键卡牌直接显示 DbId，收藏夹真实卡数（超过 9 张）也能正常显示；
• 去掉"new!"小红点：一键清空新卡标记（需要绑定快捷键，有时要重新进收藏页）。

🤖 自动化与挂机

• 绕过战网直启游戏：写好client.config或用命令行./Hearthstone.exe VerifyWebCredentials直接登录，不需要开战网客户端；
• 自动领奖：竞技场、对决、佣兵等结算奖励自动收取，省去狂点鼠标；
• 快速开包：空格键一次连开五包，还能在开包时自动分解全额返尘卡牌；
• 一键全额返尘分解：绑定快捷键，一键清掉所有可全额分解的套牌；
• 禁止踢下线：长时间无操作也不会被强制退出，挂机神器。

🎭 表情与对手信息

• 表情管控：屏蔽对手表情、限制表情次数、屏蔽思考表情、屏蔽鲍勃语音，开局还能跳过英雄入场介绍；
• 无冷却表情：自己发表情最少间隔 1.5 秒，配合快捷键想发就发；
• 完整昵称显示：显示对手完整 Battle.net 昵称和传奇段位以下的天梯等级；
• 标记对手已知牌：边打边记牌，心里更有底；
• 关闭主播模式：强制关闭并防止误触 Ctrl+Shift+S 把玩家名换成英雄名。

🎨 皮肤与外观自由

• 全套皮肤替换：匹配英雄、酒馆英雄、终结技、对战面板、幸运硬币都能改，配置写在Hearthstone\BepInEx\config\HsSkins.cfg，首次运行自动生成；
• 卡背修改：游戏内自动生效，无需重进；
• 自动镀金/钻卡：一键让卡牌变成金卡或钻石卡，佣兵还有随机皮肤、强制钻石皮肤等玩法；
• 设备模拟：模拟 iOS/Android 等设备领取对应的卡背奖励（可能需要打一局匹配）。

🛠️ 开发者与模拟工具

• 解锁开发者模式：直接进入游戏隐藏的开发者选项；
• 模拟开包：自定义卡包类型、数量、稀有度和品质，随机或固定结果都能模拟；
• 模拟掉线/拔线：绑定快捷键一键模拟断线重连；
• 冒险模式解锁：用金币购买纳克萨玛斯、黑石山、探险者协会等冒险，卡拉赞也能强制开启；
• 内置信息页：插件自带 Web 服务（默认端口 58744），浏览器打开就能看佣兵进度、开包历史等信息，还有/shell路径提供网页终端。

进阶篇：把插件调教成"你的形状"

快捷键是你的第一优先级

绝大多数快捷键都可以自由配置，但有一个例外：F4 是固定键。它负责转储游戏内信息、刷新皮肤配置、重启 Web 服务，按下即生效。其余像变速、静音、投降、模拟断线、复制战网昵称、显示 FPS 等，全部可以在设置里重新绑定。

用配置文件做精细控制

皮肤类设置建议直接编辑HsSkins.cfg。在对局中更新皮肤后，按 F4 保存，再模拟一次断线即可生效——这就是项目作者说的"游戏内一键换肤"的过渡方案。

让 Web 界面成为你的控制台

浏览器访问http://localhost:58744即可打开信息面板，支持多语言切换和实时配置更新。如果你部署在云服务器上，记得留意防火墙和安全组，这个端口默认监听所有本机 IP。

多语言自己动手补

插件内置十几套语言文件（zhCN、enUS、jaJP、koKR、ruRU等），全部放在HsMod/Languages/目录下。翻译不全怎么办？直接编辑对应的 JSON 文件重新编译即可，改完顺手提个 PR，还能为社区做贡献。

命令行参数是隐藏彩蛋

除了VerifyWebCredentials，插件还支持width、height指定分辨率，port指定 Web 服务端口，debug开启调试日志——多开、脚本启动时非常有用。

避坑清单：这些坑我替你踩过了

1. 路径绝对不能有中文：游戏安装目录、插件目录都不能包含非拉丁字符，否则插件可能无法加载，报错都找不到原因；
2. 账号安全要自己掂量：中国大陆客户端默认会启动反作弊 SDK，插件会尝试屏蔽相关检测，但不保证账号绝对安全，请务必评估风险后再决定是否使用；
3. 别和其他改 Assembly-CSharp.dll 的 Mod 混用：这类修改会错位 IL 偏移量，导致补丁失效；与其他 BepInEx 插件同时 Patch 同一方法也可能冲突；
4. 出问题先删配置：遇到异常，先删掉BepInEx\config\下对应的.cfg文件重新配置，往往能解决 80% 的问题；还不行就把HsMod.cfg一起带上反馈给社区；
5. 皮肤显示异常：优先检查HsSkins.cfg，必要时删掉HsMod.cfg重新生成；
6. 设置保存失败：看看是不是装了其他炉石插件在打架，逐个禁用排查最快。

问答速览

Q1：用了这个插件会被封号吗？任何第三方插件都存在风险。HsMod 代码完全开源、不采集任何用户信息，官方也明确提示"不保证账号安全"，建议小号体验、谨慎开启敏感功能。

Q2：游戏更新后插件还能用吗？大概率能。插件的版本号第一位对应炉石大版本，比如3.0.0.0代表适配炉石 26 版本。炉石小更新不一定会破坏插件，能正常跑就不用急着升级。

Q3：为什么我装上后什么都没变化？这是正常的！插件默认几乎全部功能都是关闭状态，需要去Esc → Mod Settings里手动开启。

Q4：战棋统计的数据存在哪？默认写入BepInEx\HsMatch.log，逗号分隔，也可以在设置里改成自定义路径。

Q5：想改翻译、加功能，怎么参与？项目欢迎一切形式的贡献：翻译去改HsMod/Languages/下的 JSON，功能建议和 Bug 反馈带上HsMod.cfg提交 issue 即可。

Q6：BepInEx 6 能用吗？暂时不能，请使用 BepInEx 5（x64 版），项目尚未适配 BepInEx 6。

写在最后

老实说，HsMod 最打动我的不是某个单一功能，而是它那种"把选择权交还给玩家"的克制——想要什么，自己打开开关；担心什么，代码全摆在你面前。对一个追求舒适体验的炉石玩家来说，这份免费开源的炉石传说插件值得你花十分钟装上试试。

从屏蔽表情到战棋开图，从一键开包到皮肤自由，说不定哪个功能就会让你喊出那句："原来还能这样玩？" 下载、装上、按自己的节奏调教它——然后，享受你的酒馆时光吧。

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