炉石传说插件 HsMod 完整指南：游戏加速、皮肤定制与对战辅助

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

如果你也厌倦了每天打完十几场快速对战后还要干等动画逐帧播完、在酒馆战棋里反复点击商店刷新按钮、满屏弹窗和提示干扰视线，炉石传说插件 HsMod 值得你花十分钟了解。它是一款基于 BepInEx 的增强工具，通过 Harmony 补丁在游戏运行时修改行为，不改动游戏核心文件，内置 55 项以上功能，覆盖游戏加速、外观定制、对战信息和一个本地 Web 面板，支持 Windows、macOS 与 Linux 三个平台。

HsMod 如何安装并启动

先明确两个前提：使用 BepInEx 5 的 x64 构建（炉石已于 2026 年 7 月转为 64 位客户端，BepInEx 6 目前尚未适配）；游戏安装路径里不能出现中文或其他非拉丁字符，否则补丁无法定位。

安装步骤以 Windows 为例：把 BepInEx x64 解压到炉石根目录Hearthstone\，将项目里HsMod/UnstrippedCorlib的 DLL 全部拷入Hearthstone\BepInEx\unstripped_corlib\，再编辑doorstop_config.ini写入：

dll_search_path_override = BepInEx\unstripped_corlib

最后把HsMod.dll放进Hearthstone\BepInEx\plugins即可。macOS 使用UnstrippedCorlibUnix目录，并在run_bepinex.sh中把架构偏好固定为 x86_64（当前客户端尚无 arm64 支持）；Linux 安装流程与 macOS 类似，执行前记得给脚本加执行权限。

三个平台的启动方式略有差别：

进入游戏后按Esc打开游戏菜单，点“Mod Settings”就能找到 HsMod 的设置面板，绝大多数功能都在这里手动开启。

加速、外观、对战信息与 Web 服务四大类功能

HsMod 的功能大致可以归到四个方向，各取所需即可。

加速类。最常用的是变速齿轮：开启后倍率可在 -32 到 32 之间调节，0 和 1 等于原速，负数用于故意放慢，8 倍和 32 倍是日常刷任务与挂机场景的常用档位，动画全程保留。另一条路线是“快速战斗”模式，它跳过大部分动画、施放终结技时屏蔽特效，节奏比齿轮更快，适用于金币获取和重复性任务。

外观定制类。你可以更换匹配英雄皮肤、酒馆英雄皮肤、卡背、终结特效、匹配面板、酒馆面板、幸运金币等元素，还可以一键把所有卡背换成金卡或钻石卡效果。具体改什么、怎么改，见下文配置部分。

对战辅助类。它会把对手的完整战网昵称、传说以下段位信息显示出来，标记对手已知的卡牌，支持屏蔽对手表情与鲍勃语音、单独屏蔽某张对手卡牌的特效；酒馆战棋里排行榜面板下方直接显示对手的 MMR，每局排名、积分变动与所用英雄会写入统计日志，还能用图表按今天、近 7 天、本月、全部以及单人/双人筛选查看。

本地 Web 服务类。插件自带一个 HTTP 服务，默认监听 58744 端口，提供配置管理页面与一个需手动开启的 WebShell，方便你在浏览器里查看佣兵进度、开包记录等信息，无需额外安装软件。

在哪里修改 HsSkins.cfg 与快捷键

游戏内设置菜单支持按分类浏览、搜索关键词和直接按键捕获绑定，是改动配置最顺手的地方。但有些场景直接改文件更高效。

皮肤配置：HsSkins.cfg

皮肤配置独立存放在Hearthstone\BepInEx\config\HsSkins.cfg，首次启动时自动生成，格式就是普通的键值对：

HERO = 123456 CARDBACK = 654321 BATTLEGROUNDSFINISHER = 111222 BATTLEGROUNDSHERO = 333444

改完按 F4 即可保存并生效；如果正在对局中，通常还需要模拟一次断线让游戏重新加载。皮肤显示异常时，先检查这个文件里的 ID 是否写错，再考虑删掉HsMod.cfg重新配置。

快捷键：F4 固定，其余可改

F4 是固定快捷键，用来输出一局内的游戏信息、重载皮肤配置并重启 Web 服务；其余快捷键都能在设置里重新绑定，常用的几个默认绑定如下：

变速倍率的加减档、继续换牌、快速认负、发送各类无冷却表情（最小间隔 1.5 秒）、酒馆商店的刷新/冻结/升酒馆/英雄技能，也都配有可改绑定的按键。

Web 端点与端口

浏览器访问http://localhost:58744/config可以得到和游戏内一致的配置界面，/shell路径则对应命令执行页，出于安全考虑必须先在设置中显式开启才能使用。需要留意的是这个端口默认监听本机所有网卡，如果你的机器在云服务器上，请自行配置防火墙，别把端口直接暴露出去。

HsMod 常见问题排查与维护

皮肤不生效或显示错乱：优先检查HsSkins.cfg里的 ID；确认无误后删除HsMod.cfg重启游戏重新生成配置。

改了配置却不保存、补丁不生效：多半是与其他插件冲突。同时修改Assembly-CSharp.dll的 mod 会打乱 IL 偏移，其他 BepInEx 插件重复打同一个方法也会互相干扰，逐个禁用排查最快。

出问题时看什么日志：运行日志在 BepInEx 目录下，战棋对局的统计数据单独记录在BepInEx\HsMatch.log，逗号分隔字段，可用脚本直接读取：

ls Hearthstone/BepInEx/HsMatch.log

版本号怎么读：HsMod 采用四段式版本号，以12.1.0.1为例：第一位 12 对应当前炉石主版本，第二位是该版本内炉石更新后 HsMod 的适配次数，第三位为 1 表示新增过功能，第四位 0 和 1 这类小数字主要对应 bug 修复。炉石更新不必然导致 HsMod 失效，插件还能正常运行的话不必急着换新版。

最后是账号安全提醒：大陆客户端默认启用反作弊 SDK，HsMod 会尝试屏蔽相关功能，但无法保证账号绝对安全，重要操作建议保留一套纯净客户端。项目遵循 AGPL-3.0 协议开源，翻译文本位于HsMod/Languages下的 JSON 文件，反馈问题时附上你的HsMod.cfg会更容易定位。打开游戏菜单里的 Mod Settings，从开启变速齿轮开始，一步步把需要的功能加上吧。

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