炉石 HsMod 完整使用指南：BepInEx 安装、功能域详解与安全边界

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

HsMod 是一款基于 BepInEx 的炉石传说（Hearthstone）开源插件，覆盖皮肤与镀金美化、酒馆战棋 MMR 显示、对局加速、挂机自动化等 60 余项本地功能，遵循 AGPL-3.0 协议，不采集任何玩家信息。本文按"环境自检 → 部署 → 加载验证 → 配置入口 → 功能域 → 安全分级 → 排障 → 问答"的顺序展开，把安装步骤、关键端口与倍速参数、风险边界一次讲清，适合刚接触炉石插件的新手。

它的工作方式很直接：BepInEx 作为插件加载器在客户端启动时接管运行时，HsMod 则以一个 DLL 的形式注入并打补丁（patch），所有改动仅在游戏进程内生效，退出即还原。理解这一点，是后面判断"哪些功能安全"的基础。

部署前环境自检

部署前先确认四项前提，任一项不满足都会导致加载失败或后续冲突：

1. 客户端位数：炉石已于 2026-07-01 起改为 64 位程序，BepInEx 必须选x64版本；且当前只适配BepInEx 5.x，BepInEx 6 仍处 pre-release，暂不支持。
2. 安装路径：Hearthstone\根目录路径不能含中文等非拉丁字符，否则插件无法放置与加载。
3. 编译器（自建时才需要）：自行编译需要.NET SDK 8.x；直接下载HsMod.dll则无需编译器。
4. 反作弊预期：大陆客户端默认启动暴雪反作弊 SDK，插件会尝试屏蔽相关检测，但无法保证账号绝对安全——这是所有后续风险判断的前提。

Windows 安装步骤

以下五步对应 Windows 环境，每步只改一处：

1. 解压加载器：把 BepInEx 5.x 的 x64 压缩包解压到炉石根目录Hearthstone\。
2. 补齐运行库：新建Hearthstone\BepInEx\unstripped_corlib\，将仓库中 HsMod/UnstrippedCorlib/ 下的全部 DLL 复制进去（Linux/macOS 则使用 HsMod/UnstrippedCorlibUinx/）。
3. 指定搜索路径：编辑doorstop_config.ini，把dll_search_path_override一行改为BepInEx\unstripped_corlib（旧版 BepInEx 写作dllSearchPathOverride，等号前无空格）。
4. 放入插件：将HsMod.dll放进Hearthstone\BepInEx\plugins。
5. 启动客户端：正常进入游戏即可。

Linux / macOS 用户改用 BepInEx 的 unix 版，在run_bepinex.sh里配置dll_search_path_override与executable_name（macOS 下还需把架构偏好改回x86_64，因为炉石暂未适配 arm64）。

想从源码构建时，克隆仓库后执行dotnet build --configuration Release即可，仓库地址为 https://gitcode.com/GitHub_Trending/hs/HsMod ；构建脚本 HsMod/install.bat 会在 BepInEx 已就绪时把产物自动拷进默认炉石目录。

验证插件是否真正加载

进入客户端后按Esc打开主菜单，看到Mod Settings按钮即代表插件已生效。若按钮缺失，不要反复重装，先做两处检查：

1. 打开BepInEx\LogOutput.log，确认有 HsMod 的加载行且没有成片的红色报错。
2. 核对unstripped_corlib是否齐全、doorstop_config.ini是否改对——多数"按钮没出现"都源于这两处。

还要建立两个正确预期：绝大多数功能默认是关闭的，看不到变化不代表没生效，需要进设置手动开启；版本号也说明这一点——HsMod 的大版本号跟随炉石大版本，炉石更新后功能仍正常就可以继续沿用，不必每次强更。

配置入口与快捷键

三个入口同源，改的是同一套配置，按需选择：

1. 游戏内菜单（推荐）：Esc→Mod Settings，带分类、搜索与按键重绑。
2. 网页配置：插件内置 Web 服务默认监听本机58744端口，浏览器打开即可多语言切换并实时保存；页面资源见 HsMod/WebResources/。
3. 配置文件：Hearthstone\BepInEx\config\下的HsMod.cfg（主配置）与HsSkins.cfg（皮肤映射），适合逐行精调。

快捷键上，F4是固定键，用于刷新皮肤配置、重启 Web 服务并导出部分对局信息；其余按键均可在菜单里重绑。例如把表情绑到数字键 1–6，再配合"无冷却表情"（最小发送间隔1.5 秒）即可快速表达。

功能域详解

按作用对象把功能分成四个域，便于你只取所需、不碰高风险项。

展示美化域：皮肤、镀金与外观

• 自动镀金 / 钻石卡：普通卡牌以金色或钻石特效呈现，纯本地替换。
• 皮肤自定义：英雄皮肤、卡背、幸运币、对战面板、酒馆面板、终结特效、宠物皮肤均可改。
• 皮肤映射：在HsSkins.cfg里按原皮肤ID:替换皮肤ID逐行书写，支持a:b,c,d的随机多选。
• 外观本地解锁：酒馆等外观本地全部显示为已解锁，仅用于"看脸"。

域内技巧：对局中途想换皮肤，需先允许报错弹窗，按快捷键模拟断线，再按F4刷新皮肤配置。

对战提效域：战棋信息、节奏与交互

• 对手 MMR 显示：排行榜上直接标出每位对手的隐藏匹配分，开局先摸清强弱。
• 对局统计：每把排位记录名次、分差与英雄，生成今日 / 7 天 / 本月 / 全部的曲线，支持单人 / 双人筛选。
• 商店快捷键：购物阶段可快速刷新、冻结、升酒馆、放技能，双人模式还能查看队友棋盘。
• 快速战斗：跳过部分动画，酒馆与佣兵 PVE 均可用，终结特效在施放时被遮蔽。
• 变速运行：默认最高8 倍，设置里可放宽到32 倍。

日常刷任务 4 倍速较稳，8 倍接近体验上限，32 倍建议只在测试环境使用，过快易出现画面撕裂。

挂机自动化域：领奖、开包与无人值守

• 免战网登录：基于VerifyWebCredentials启动，支持命令行拉起，无需先开战网客户端。
• 禁用掉线：允许长时间无操作而不被踢，是挂机的前提。
• 自动领奖：竞技场、对决、佣兵等奖励在结束时自动收下。
• 快速开包：空格一次开 5 张，可在开包时自动分解"全额返尘"的卡（该功能有已知 bug，首次启用建议前台盯着）。
• 屏蔽报错 / 自动退出：可阻断异常上报，或允许上报并自动退出。
• 定时退出：设置运行时长，到点自动关游戏。

把"定时退出 + 免战网启动"组合，即可实现无人值守的"刷完即走"。

实验调试域：模拟、开发者与 Web 面板

• 模拟开包：自定义卡包类型、数量、稀有度与品质，支持随机或固定结果。
• 设备模拟：伪装 iOS / Android 等设备以领取对应平台的卡背（可能需打满一局）。
• Web 信息面板：默认58744端口，查看对局统计、开包历史等；/config入口与游戏内菜单同源，批量调参更快。
• 开发者选项：解锁隐藏的 Developer Mode，以及模拟拔线、读取本地文件等实验能力。

安全分级与红线

判定标准只有一条：功能是否在服务端产生奖励或购买类的交互。按此把功能分成三级：

• 低风险：纯本地展示，不触发服务端交互。如皮肤、镀金、MMR 显示、对局统计、快速战斗（仅改本地动画节奏）。日常可以放心开。
• 中风险⚠️：涉及本地执行但有已知 bug，或存在轻微服务端交互。如自动开包（有已知 bug）、设备模拟（领真实卡背）、自动领奖、无冷却表情。建议用小号或接受风险后再开。
• 高风险⚠️：直接改动奖励 / 购买流程，源码注释与社区均提示"有概率被封号"。如金币购买冒险、强制开启卡拉赞。除非用小号，否则直接绕开。

需要澄清两点：其一，"开源（AGPL-3.0）"不等于"绝对安全"，HsMod 不采集玩家信息，但账号安全不由开源协议背书；其二，卡牌揭示一类功能可能触发强制断线重连，也应归入谨慎使用。若你只想稳妥，就停留在低风险域。

故障排查速查

按"症状 → 最可能原因 → 处理"排查：

• 装完游戏打不开：依次核对 BepInEx 是否解压到根目录、unstripped_corlib是否齐全、doorstop_config.ini是否改对、安装路径是否含中文、插件与 BepInEx 版本是否匹配；答案通常在BepInEx\LogOutput.log。
• 皮肤显示错乱：先查HsSkins.cfg映射格式，仍不对就删除HsMod.cfg重新配置。
• 设置存不上：多半是同时启用了其他炉石插件在互相打架，逐个排查谁抢了同一处补丁。
• 游戏更新后失效：大版本号对应炉石大版本，只有更新改动了Assembly-CSharp.dll这类关键文件才需换新版本；能进游戏且功能正常就继续用。
• 补丁整体不生效：与基于Assembly-CSharp.dll的修改共存会造成 IL 偏移错位；也避免多个 BepInEx 插件同时修补同一方法。
• 想恢复出厂：删除BepInEx\config\下对应的.cfg重新配置；彻底回滚则移除HsMod.dll（甚至整个BepInEx目录）即可，游戏本体文件从未被改动。

高频问答

Q1：怎样在安全底线内使用？只开低风险类的本地展示功能（皮肤、镀金、MMR）。中风险类（自动开包、设备模拟）用小号或接受风险再开。高风险类（金币购买冒险、卡拉赞修复）源码注释明确"有概率被封号"，直接绕开。卡牌揭示可能触发强制断线重连，同样谨慎。

Q2：游戏更新后必须跟着更新插件吗？不一定。大版本号对应炉石大版本，只有更新改动了Assembly-CSharp.dll等关键文件才需要换新版本。先试进游戏，能用就继续用。

Q3：可以绕过战网客户端直接启动吗？可以。配好client.config后直接执行./Hearthstone.exe VerifyWebCredentials即可；token 过期导致打不开时，更新client.config里的 token。这对挂机流程尤其顺手。

Q4：出问题怎么回滚？HsMod 不改游戏本体任何文件——删掉BepInEx\plugins里的HsMod.dll即还原；想彻底回滚，移除整个BepInEx目录。只是设置乱了，删对应.cfg重配即可，无需卸载。

收益与安全收尾

HsMod 的价值集中在三处：把排队、逐一点奖励、机械刷任务的时间省回来，用本地展示让对局观感更顺，用 Web 面板与开发者选项满足调试需求。它是一份工具箱，开哪些、关哪些由你决定——插件为玩法服务，而不是反过来。

最后重申安全边界：低风险类放心用，中风险类用小号或接受风险，高风险类（金币购买、卡拉赞修复）直接绕开。记住"开源不承诺绝对安全"，在反作弊默认开启的大陆客户端上，控制功能范围就是控制风险本身。

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