HsMod 炉石传说插件完整使用指南：安装、本地换皮、战棋统计到风险边界
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一款基于 BepInEx 的炉石传说（Hearthstone）本地修改插件，内置皮肤换装、卡牌镀金、酒馆战棋 MMR 显示、对局统计、AFK 自动领奖等 60 余项功能，遵循 AGPL-3.0 开源协议，不采集任何玩家信息。它只改本地客户端行为、不改游戏文件，但涉及服务端奖励的功能存在账号风险——下文分级标清边界。
动手之前，先把风险底线说清楚
把游戏客户端想成一台出厂就焊死的收音机：内部电路（游戏逻辑）你动不了，BepInEx 是插在那唯一空闲插座上的转接头，HsMod 就是你接上去的一枚外接调频模块。拔下模块、关掉电源，机器立刻回到出厂状态——这就是它"插上即生效、拔掉即复原"的原因，也意味着所有改动都发生在进程内存里，不落盘到游戏文件。
正因为只动内存，HsMod 把功能分成了清晰的风险梯度，判断依据直接写在源码与配置注释里：
- 🟢 本地展示类：皮肤、镀金、MMR 显示、对局统计。只改你屏幕上的画面，不产生任何服务端交互，最放心。
- 🟡 自动操作类：自动领奖、开包加速、定时退出、卡牌揭示。会替你点按钮或触发断线重连，可能踩到已知 bug，建议用小号或接受风险再开。
- 🔴 服务端交易类：零元购、冒险购买、卡拉赞修复。源码注释明确写着"有概率导致账号被暴雪封禁""有概率封号，酌情考虑使用"，除非用小号，否则别碰。
还有一条全局提示：大陆客户端默认启动暴雪内置的反作弊 SDK，HsMod 会尝试屏蔽相关检测，但作者不承诺账号绝对安全。"开源"不等于"安全"，这是贯穿全文的判断前提。
Windows 五步装好 HsMod 并确认生效
先满足三个硬前提，否则后面全白搭：
- 用 BepInEx 5.x。BepInEx 6 还在预览阶段，HsMod 尚未适配。
- 选 x64 版。炉石从 2026-07-01 起已是 64 位程序，32 位 BepInEx 会直接失败。
- 安装路径不含中文、空格以外的非拉丁字符。路径带中文会导致加载失败。
完整步骤
- 拿到
HsMod.dll：从 Releases 直接下载，或自己编译（见下文）。 - 把 BepInEx x64 整个解压到炉石根目录
Hearthstone\。 - 新建
Hearthstone\BepInEx\unstripped_corlib\，把 HsMod/UnstrippedCorlib 目录下的全部 DLL 拷进去。这一套是炉石运行时要用的"未剥离"库，缺一个都可能崩。 - 编辑
Hearthstone\doorstop_config.ini，把dll_search_path_override改成BepInEx\unstripped_corlib（旧版 BepInEx 写成dllSearchPathOverride=BepInEx\unstripped_corlib）。这一步是告诉游戏去哪找上面那套库。 - 把
HsMod.dll放进Hearthstone\BepInEx\plugins，启动游戏。
如何确认插件真的加载了
进游戏按Esc（或点齿轮）打开主菜单，看到Mod Settings按钮就说明插件已挂上；再翻BepInEx\LogOutput.log，出现 HsMod 的加载行且没有红色报错即通过。
有两个最容易误判的点：其一，绝大多数功能默认是关的，看不到画面变化不代表没生效，得去设置里手动打开；其二，找不到按钮就直接跳去下面的排障部分。
自己编译与其他平台
编译需要 .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，编译脚本 HsMod/install.bat 会自动把它拷进默认炉石目录（前提是那边已经配好 BepInEx，否则只会提示 "BepInEx is not exist!"）。
macOS 用BepInEx_macos_universal，DLL 换用 HsMod/UnstrippedCorlibUinx，在run_bepinex.sh里设置dll_search_path_override与executable_name，并把架构改成x86_64（炉石目前不是 arm64）。Linux 一般先用hearthstone-linux装客户端，同样用UnstrippedCorlibUinx，在run_bepinex.sh配好DOORSTOP_CORLIB_OVERRIDE_PATH与executable_name后chmod u+x再运行。
三个地方都能改配置
改设置有三个入口，同源同效：
- 游戏内菜单：
Esc→ Mod Settings，有分类、搜索框和快捷键抓取，最适合日常调。 - 网页界面：内置 Web 服务默认监听本机58744端口，浏览器打开就能多语言切换、实时保存；
/config页和上面的菜单是同一套数据，批量改参数比一个个点快。 - 配置文件：
Hearthstone\BepInEx\config\下的HsMod.cfg（主配置）与HsSkins.cfg（皮肤映射），适合直接编辑精调。
有一个固定键F4不能被重绑：它会重新加载皮肤配置、重启 Web 服务、并在 BepInEx 目录落一份当前皮肤信息。其余快捷键（表情、商店、变速等）全部可重绑。
功能详解：按你要解决的问题分组
下面每块都写清"是什么 + 怎么用 + 风险等级"，再给一两个组合玩法。
目标一：只想改外观、图个好看 🟢
- 皮肤替换：英雄皮肤、卡背、幸运币、对战面板、酒馆面板、击杀特效，连宠物（含对手宠物）都能换。在游戏内菜单的皮肤分类里填偏好 ID（
-1表示不改），或用HsSkins.cfg按原皮肤ID:替换皮肤ID逐行写映射，支持274:57761,57800这种多值写法实现"随机换到某几个皮肤"。 - 卡牌镀金/钻石：把普通卡显示成金卡或钻石特效，纯本地换装，不影响结算。
- 酒馆外观本地解锁：把全部酒馆战棋外观在本地显示为已解锁，只用于看脸。
组合玩法：对局中想换英雄皮肤，先关闭"报错退出"、允许弹窗，按模拟拔线键（默认Ctrl+D）强制掉线重连，再按F4刷新皮肤配置——这是目前唯一能中途生效的途径（作者在 Roadmap 里列了"一键换英雄皮肤"为待做项）。
目标二：战棋里看得清、打得快 🟢
- 对手 MMR 显示：排行榜里每个对手名字下方显示其 MMR（隐藏匹配分），单人/双人都生效，开局前先摸清对面深浅。
- 对局统计：每把排位自动记录名次、分差、英雄，写入 CSV 并画出今日/7 天/本月/全部的趋势图，还能按单人/双人、按英雄过滤。它还会在后台定期"对账"，把崩溃丢掉的分数变化补记进来，保证统计和真实分始终一致。
- 商店快捷键：购物阶段按
R刷新、F冻结、U升酒馆、H放英雄技能，双人模式还能按T显示/隐藏队友棋盘。只在你真正处在购物阶段时有效，聊天打字时不会误触。 - 快速战斗：跳过一部分动画，让酒馆和佣兵 AI 局更顺，放技能时会保护击杀特效不被吞。
- 炉石变速：把全局
timeScale改掉，配置范围 -32~32，但实际生效封顶8 倍、最低慢到 0.125 倍；方向键默认就绑了加减倍率和归零。
组合玩法：日常刷任务用 4 倍足够稳，8 倍是极限；想连 MMR 显示、统计、商店快捷键一起享受，把它们都打开后，整局基本只剩"看分 + 按 R/F/U/H"。风险仍是 🟢，因为这些都只改变你本地的显示与动画节奏。
目标三：挂着刷奖励、人不守着 🟡
- AFK 模板：设置里的一键模板，把"关弹窗、自动开盒、自动领奖、禁掉线、开包加速、跳过英雄介绍"等一组开关一次性配好，改完自动还原为 DoNothing，避免反复手点。
- 自动领奖：竞技场、对决、佣兵的结算宝箱自动点开收下。
- 开包加速：按空格直接出结果、一次开五包，还能选开包时自动分解"全额可返尘"的卡（此项启动时会自动禁用，必须手动开启）。
- 定时退出：设一个运行秒数，到点自动关游戏；若正好在对局中会等结算，超过 1818 秒则强制退出，防止卡死。
组合玩法：把"定时退出 + 免战网启动"（见下文 FAQ）组合起来，就是一套"刷完即走"的流程——下班挂着，到点自己收工。 风险提醒：🟡 "自动开包"配置注释标着"慎用，有 BUG"，首次启用建议前台盯着确认分解结果；"允许掉线"标注"尚未测试"，别指望它 100% 可靠。
目标四：钻到游戏底层看数据 🟢~🔴
- Web 信息面板：内置 Web 服务，默认端口 58744，浏览器打开能看到佣兵进度、开包记录、对局日志等，页面资源见 HsMod/WebResources/。另有
/shell调试页（需在设置里单独开启）。 - 模拟开包：自定义卡包类型、数量、稀有度、品质，想看全金包长什么样就随便配，纯本地，不联网。
- 开发者选项：解锁游戏隐藏的 Developer Mode、内部模式，是折腾党的玩具箱。
- 设备模拟：伪装成 iOS/安卓设备去领对应平台的卡背奖励，可能需要打一局匹配。
- 卡牌揭示 / 卡牌追踪：明牌展示已知的对手牌（有概率触发自动断线重连），或推测对手手牌（有概率识别错误）。
组合玩法：网页/config入口和游戏内菜单同源，批量调参时比逐个点快得多；/pack页可回看历史开包，配合模拟开包做"预演"。 风险分层要分清：模拟开包、Web 面板是 🟢（本地）；设备模拟涉及真实奖励领取，是 🟡；零元购、冒险购买（纳克萨玛斯/黑石山/探险者协会/卡拉赞）、卡拉赞修复是 🔴——源码注释白纸黑字"有概率封号"，除非小号否则绕开。
出问题时怎么定位
启动后游戏直接闪退或白屏— 十有八九是路径或库没铺对。按顺序查：BepInEx 是否解压在根目录、unstripped_corlib里的 DLL 是否齐全、doorstop_config.ini是否改到BepInEx\unstripped_corlib、安装路径有没有中文；答案多半写在BepInEx\LogOutput.log里，先读它再动别的。
插件按钮在、但点了没反应或功能不生效— 多数是别的炉石插件抢了同一处补丁。多个 BepInEx 插件同时修改同一个方法会导致 IL 偏移错位，HsMod 本身不检测原方法是否被动过。逐个禁用其他插件（佣兵类、MixMod 等）再试；凡是直接改Assembly-CSharp.dll的 mod 都容易和它打架。
皮肤显示错乱或映射不生效— 先查HsSkins.cfg的格式（原始:替换，冒号必须半角），支持a:b,c,d随机；仍不对就删掉HsMod.cfg重新配置。改完记得按F4重载，对局中还要模拟拔线。
设置改了存不上— 大概率是同时启用了其他插件在互相覆盖。按上面那样逐个排查谁抢了同一处，确认只剩 HsMod 后再存。
炉石更新后功能失效— 不一定需要换新。HsMod 版本号第一位对应炉石大版本，只有当更新动了Assembly-CSharp.dll这类关键文件时才需要换 Releases 里的新版；还能正常进游戏、功能正常就继续用。
想一键回到出厂— HsMod 从不改游戏本体，删掉BepInEx\plugins\HsMod.dll游戏就恢复原样；只是设置乱了的话，删BepInEx\config\下对应的.cfg重新配即可，不必整个卸载。
关于安全的几个问答
Q1：怎么在安全底线内使用？A：只开 🟢 本地展示类（皮肤、镀金、MMR、统计）。🟡 自动操作类用小号或接受 bug 风险再开。🔴 零元购、冒险购买、卡拉赞修复源码注释明确"有概率封号"，直接绕开；卡牌揭示可能触发断线重连，也归入谨慎使用。记住：HsMod 不采集玩家信息，但"开源"不等于"绝对安全"。
Q2：炉石更新后要不要跟着更新插件？A：不一定。版本号第一位对应炉石大版本，只有更新动了Assembly-CSharp.dll等关键文件才需换新。先试着进游戏，能用就继续用，功能变化可以靠提交记录追踪。
Q3：可以不用战网客户端启动吗？A：可以。配好client.config后直接执行./Hearthstone.exe VerifyWebCredentials即可绕过战网启动；token 过期打不开时，更新client.config里的 token。大陆区Env填cn.actual.battlenet.com.cn。这条对挂机路线特别顺手。
Q4：出问题怎么回滚还原？A：HsMod 不改任何游戏文件——删BepInEx\plugins\HsMod.dll即复原；想彻底回滚，把整个Hearthstone\BepInEx文件夹删掉即可。只是设置乱了，删对应.cfg重配就行。
Q5：内置 Web 服务会不会带来额外风险？A：它默认监听本机所有本地 IP（58744 端口），在普通家用网络没问题；但如果你在游戏机上开了公网暴露，务必注意防火墙与安全组，别把这个端口映射出去。
结语
回到开头那台焊死的收音机：BepInEx 只是给你一个插座，HsMod 是那枚调频模块，而开哪几个频道、开到什么音量，决定权在你手里。60 余项功能只是工具箱，🟢 放心用、🟡 小号试、🔴 别碰——把红线守住，炉石才能一直好玩。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
