企业官网建设流程全解析

HsMod 炉石传说插件完整部署指南：8 倍速加速、皮肤替换、对手信息一次配齐

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

HsMod 是一款基于 BepInEx 框架的炉石传说增强插件，通过 Harmony 热补丁在运行时修改游戏行为，不改动游戏本体文件。它覆盖提速、外观定制、局内信息三类需求，项目遵循 AGPL-3.0 协议，不收集任何用户数据，定位为学习与研究用途，支持 Windows、macOS 与 Linux 三个平台。

🧩 功能总览：按使用场景划分的完整清单

先说清楚一点：插件的绝大多数功能默认是关闭的，装完后要在面板里逐项开启。所以部署之前值得把能力清单过一遍。

• 提速与挂机：齿轮变速（默认 8 倍上限，可配置到 32 倍）、Fast battle 动画跳过模式、禁用掉线检测以支持长时间无操作不被踢下线，以及启动参数afk=1一键套用挂机模板。
• 外观：匹配与酒馆的英雄皮肤、终结特效、匹配/酒馆面板、幸运金币、卡背、表情边框均可替换；其中卡背配置后自动生效，无需额外操作。
• 局内信息：显示对手完整战网昵称、传奇之前的天梯等级，并给对手的已知卡牌打标记；酒馆战棋排行榜覆盖层在每个玩家名下显示 MMR（双人模式于匹配开始时后台加载）；每局天梯的排名、MMR 变化、所用英雄写入 CSV，页面提供今日 / 7 天 / 本月 / 全部的图表视图。
• 表情与清理：自动屏蔽对手表情、屏蔽思考表情、屏蔽布伯语音；自己发表情无冷却（最小间隔 1.5 秒），六种常用表情各配一个快捷键；自动领取竞技场、对战、佣兵奖励（结束时自动打开奖励包）；自动举报并生成交互日志；一键清除收藏夹的new!标记；收藏夹卡牌数显示真实数字而非 9+。
• 自动化与快捷键：空格一次开 5 包，可选"开包时自动分解可全额返还的卡"；再配一个快捷键可一键分解整副可退牌组；酒馆的刷新、锁刷新、酒馆升级、英雄技能、看队友棋盘五个动作全部可重绑，且只在购物阶段生效。
• 界面与其他：解除窗口缩放与焦点限制；屏蔽匹配失败、推广、结算奖励等弹窗；右键点选卡牌显示 DbId；静音快捷键。

部署前的环境自查：四个硬性条件

动任何文件之前，先确认下面四条，每一条都会直接影响插件能否加载。

1. BepInEx 必须是 5 系列的 x64 包。炉石客户端自 2026-07-01 起转为 64 位程序，而 BepInEx 6 仍处于预发布阶段、未适配当前版本，不能用。
2. 游戏安装路径的任何一层目录都不能含中文或其他非拉丁字符。这是实际反馈里出现次数最多的问题，务必整条路径检查一遍再部署。
3. 自行编译需要 .NET SDK 8.x；直接拿 Release 版的HsMod.dll则不依赖开发环境。
4. 准备好项目里的运行时 DLL：Windows 用HsMod/UnstrippedCorlib，macOS 和 Linux 用HsMod/UnstrippedCorlibUinx。

🚀 完整部署流程：先 Windows，再看 macOS 与 Linux

Windows：编译或下载，然后四步放到位

想自己编译的话，产物在HsMod/Release/HsMod.dll：

git clone --depth 1 --branch bepinex5 https://gitcode.com/GitHub_Trending/hs/HsMod cd HsMod dotnet build --configuration Release --no-restore

不想编译就直接从发布版下载现成的HsMod.dll。接下来四步：

1. 把 BepInEx 5 的 x64 包解压到炉石根目录Hearthstone\。
2. 新建Hearthstone\BepInEx\unstripped_corlib\，把UnstrippedCorlib里的 DLL 全部拷进去。
3. 编辑Hearthstone\doorstop_config.ini，写入下面这行（BepInEx 5.4.23.2 之前的旧包键名是dllSearchPathOverride）：

dll_search_path_override = BepInEx\unstripped_corlib

4. 把HsMod.dll放进Hearthstone\BepInEx\plugins，正常启动游戏。

macOS：universal 包加 x86_64 偏好

用 BepInEx 5 的 macos universal 包解压到游戏根目录，运行时库改用UnstrippedCorlibUinx（其中的 Mono 与 Unity 版本必须和炉石客户端匹配）。在run_bepinex.sh里把executable_name设为"Hearthstone.app"，并把ARCHPREFERENCE改为x86_64——炉石目前没有 arm64 原生支持。

Linux：社区客户端加 unix 版 v5 包

先通过社区方案装好炉石 Linux 客户端（一般顺带帮你配好client.config），再解压 BepInEx 的 unix 版 v5 包到游戏根目录。在run_bepinex.sh中设置DOORSTOP_CORLIB_OVERRIDE_PATH与executable_name后执行./run_bepinex.sh即可。

首次进游戏：Mod Settings 面板与 58744 网页控制台

进入游戏后按Esc，在游戏菜单里点Mod Settings打开设置面板，逐项开启需要的功能。如果装完面板没有任何反应，先回头核对两件事：路径是否含非拉丁字符，BepInEx 是否是 5 系列 x64。

面板不好用时还有备用入口：插件自带一个 Web 服务，默认端口58744，启动后浏览器访问本机该端口即可。/config是网页版配置管理页；/shell是 WebShell，默认关闭，需要在设置里显式开启，且中文显示可能乱码；Showinfo 页面可以查佣兵养成进度、开包历史，玩佣兵的人会常用。两个细节：按 F4 会顺带重启这个 Web 服务；端口默认监听所有本地 IP，如果炉石跑在云服务器上，记得检查防火墙和安全组，别把它暴露到公网。

⚡ 加速体系：默认 8 倍、可配到 32 倍，两种提速模式

在设置里开启齿轮加速后，档位用方向键切换：上/下键加减速，左/右键回到默认档或最大档。倍率上限在HsMod.cfg的timeGear项调整，允许范围 -32 到 32（1 和 0 倍率相同，负值表示减速）。默认上限 8 倍速，拉到 32 后动画保留、整体节奏明显加快，适合边打日常边刷金币。

想要更干脆就开 Fast battle（快速模式）：直接跳过大部分动画，放终结技时连特效一起屏蔽；佣兵 PvE 的酒馆同样能用，只是最后的死亡结算偶尔会卡一下。再搭配"禁用掉线检测"，长时间无操作也不会被踢，刷金币场景建议这两项一次配齐。

不想进面板的可以直接用启动命令行参数afk=1：插件会自动把齿轮置零并套用 AwayFromKeyboard 挂机配置模板，省掉全部手动设置。

🎨 皮肤与卡背替换：F4 导出、写映射、再 F4 生效

所有外观替换集中在Hearthstone\BepInEx\config\HsSkins.cfg，首次运行自动生成。可替换的对象包括匹配/酒馆英雄皮肤、终结特效、匹配与酒馆面板、幸运金币、卡背、表情边框等。流程分三步：

1. 查 ID：按F4，插件会把当前全部皮肤信息（含 DbId）导出到 BepInEx 目录，照着查出原始皮肤 ID。
2. 写映射：在HsSkins.cfg里按原始ID:替换ID的格式写映射，例如把玛法里奥换成大导师玛法里奥；写成a:b,c,d这种多值形式则是随机皮肤。
3. 应用：改完再按一次 F4 更新配置；如果正在对局中，还需要触发一次模拟断线才生效。卡背替换例外，配置后自动生效。

换了 ID 没反应时，先核对映射值是否正确，仍不行就删掉HsMod.cfg重新配置。

版本号解读：四位数字各自对应一类变化

以12.1.0.1为例拆开看：第 1 位对应当前炉石主版本号；第 2 位统计该炉石版本内更新且实际改动了Assembly-CSharp.dll等文件的次数，没改动到这些文件的更新不计入；第 3 位在该炉石版本下新增功能时 +1，且第 2 位变化时清零；第 4 位是编译版本，主要跟随第 3 位的 bug 修复。

由此得出一个实用结论：炉石更新后插件不一定失效，只要现有功能都正常，就没有必要急着换 Release 里的新版。

排障速查：从最常见到最少见的问题顺序

• 插件加载不了：大概率是安装路径某一层含中文或其他非拉丁字符。把整条路径全部改成纯拉丁字符后重启游戏。
• 面板不出现：多半用了 BepInEx 6 或非 x64 包。换回 BepInEx 5 的 x64 版本重新部署。
• 设置保存不上、补丁失效：常见于其他 mod 改过Assembly-CSharp.dll导致 IL 偏移错位，或佣兵类 / MixMod 类插件对同一方法做了二次补丁。第一步应当怀疑并禁用其他插件再试。
• 皮肤显示异常：HsSkins.cfg里的 ID 写错了。核对映射值；仍无效则删HsMod.cfg重新配置。
• 以上都无效：删掉BepInEx\config\下相关的.cfg让其重新生成；再找人排查时附上你的HsMod.cfg。

日常排查还有两个信息源：对局统计日志BepInEx\HsMatch.log（逗号分隔，路径可在设置里改）和 BepInEx 自身的运行日志。想深入看每个补丁怎么实现的，可以浏览 HsMod/Patches/ 目录下的源码。

必须知道的三件事：账号风险、F4 固定键与免战网启动

国服账号安全：国服炉石客户端默认启用反作弊 SDK，HsMod 会尝试屏蔽相关功能，但无法保证账号安全。作者明确把项目定位为学习与研究用途，风险由使用者自行评估；如果在意账号，建议把修改类功能留在非主力环境使用。

唯一写死的快捷键是 F4：导出局内信息（存到 BepInEx 目录）、更新皮肤配置、重启 Web 服务三件事都挂在它上面。加速档切换、模拟断线、投降、静音、开包、酒馆五件套、表情等其余快捷键全部可以在设置面板重绑。

不经过战网客户端也能启动：在炉石根目录放一个client.config，[Aurora]段写入登录凭证：

[Aurora] VerifyWebCredentials = "TOKEN"

Token 从对应地区战网登录链接的跳转地址中取?ST=之后、&accountId=之前的部分；国服的Env值为cn.actual.battlenet.com.cn，其他地区一般取 Token 前两位对应。配好后运行Hearthstone.exe VerifyWebCredentials即可启动，Token 过期后更新该文件里的值就行。

更多安装细节、全部设置项以及多语言文件的说明，可查阅仓库内的 ReadMe.md 与 HsMod/Languages/。

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