炉石传说HsMod插件完全指南：55项功能详解与全平台安装教程

HsMod是基于BepInEx框架开发的炉石传说功能增强插件，为玩家提供55项实用功能，从游戏性能优化到个性化定制，全方位提升游戏体验。这款开源插件完全免费，不收集用户任何个人信息，遵循AGPL-3.0协议，是炉石玩家必备的辅助工具。

为什么选择HsMod插件？

炉石传说作为全球最受欢迎的卡牌游戏，玩家在长期游戏中会遇到诸多痛点：动画时间过长影响效率、界面限制影响操作、反作弊系统影响账号安全等。HsMod正是为解决这些问题而生，通过非侵入式的方式为游戏注入强大功能。

安全提示： 中国大陆的炉石传说客户端默认启动反作弊SDK，插件会尝试屏蔽相关功能，但无法保证账号绝对安全。建议在了解风险的前提下谨慎使用。

55项核心功能全面解析

游戏性能优化类

1. 加速功能：支持8倍游戏速度调节，可扩展到32倍
2. 帧率控制：允许修改游戏帧率，显示实时帧率信息
3. 快速对战：跳过部分动画效果，对战更加流畅
4. 自动收集奖励：自动领取竞技场、决斗等模式结束后的奖励

操作体验提升类

5. 免战网启动：支持VerifyWebCredentials方式登录，无需启动战网客户端
6. 无冷却表情：表情发送无冷却时间，最短间隔1.5秒
7. 表情快捷键：为常用表情设置快捷键
8. 快速开包：空格键一次开5包，支持自动分解重复卡牌
9. 窗口管理：移除窗口大小限制，支持窗口失焦

界面信息增强类

10. 对手信息显示：显示对手完整战网昵称和天梯等级
11. 卡牌信息显示：在收藏中右键显示卡牌Dbid
12. 标记已知卡牌：在游戏中标记对手已知的手牌
13. 收藏管理：显示9+实际卡牌数量，一键分解多余卡牌

个性化定制类

14. 皮肤修改：支持英雄皮肤、卡背、最终效果等个性化定制
15. 自动金卡钻石卡：自动将普通卡牌升级为金卡或钻石卡
16. 屏蔽提示：移除削弱补丁提示、广告、天梯结算奖励等弹窗

高级功能类

17. 开发者模式：开启炉石传说开发者模式
18. 设备模拟：模拟iOS、Android设备，收集特定卡背
19. 信息显示服务：默认HTTP端口58744，显示佣兵养成进度、开包历史等信息

快速安装指南

从源码构建

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 文件。

Windows系统安装步骤

1. 下载BepInEx框架

   • 下载BepInEx_x86版本并解压到炉石传说根目录

2. 配置依赖环境

   • 创建目录 Hearthstone\BepInEx\unstripped_corlib\
   • 将项目 HsMod/UnstrippedCorlib 目录下的所有dll文件复制到上述目录

3. 修改配置文件

   • 编辑 doorstop_config.ini 文件
   • 将 dllSearchPathOverride= 修改为 dllSearchPathOverride=BepInEx\unstripped_corlib

4. 放置插件文件

   • 将 HsMod.dll 放置在 Hearthstone\BepInEx\plugins 目录

MacOS系统安装步骤

1. 下载BepInEx_macos_x64版本并解压到游戏目录

2. 复制依赖库文件

   • 将 HsMod/UnstrippedCorlibUnix 目录下的所有dll文件复制到对应目录

3. 配置启动脚本

   • 修改 run_bepinex.sh 文件中的相关路径

4. 设置执行权限

   chmod u+x run_bepinex.sh
   

Linux系统安装步骤

1. 安装炉石传说Linux版本

   • 参考相关项目完成基础安装

2. 配置BepInEx环境

   • 下载BepInEx_unix版本并解压

3. 修改脚本配置

   • 替换 run_bepinex.sh 中的路径参数
   • 使用 sed 命令修正文件换行符

配置文件详解

client.config配置

创建 client.config 文件，内容如下：

[Config]
Version = 3
[Aurora]
VerifyWebCredentials = "TOKEN"
ClientCheck = 0
Env.Override = 1
Env = us.actual.battle.net

注意： 中国区的Env参数应为 cn.actual.battlenet.com.cn

使用技巧与优化建议

快捷键配置

• F4键：固定功能键，用于获取游戏信息、更新皮肤配置等
• 空格键：快速开包，一次开启5包
• 自定义快捷键：在插件设置中配置个性化快捷键

皮肤配置管理

• 配置文件路径：Hearthstone\BepInEx\config\HsSkins.cfg
• 修改后需按F4保存并重启web服务

故障排除指南

常见问题解决方案

插件不生效

• 检查游戏路径是否包含中文字符
• 验证BepInEx配置是否正确
• 确认依赖文件是否完整复制

设置无法保存

• 检查是否有其他插件冲突
• 确认配置文件权限设置
• 删除配置文件重新生成

皮肤显示异常

• 检查皮肤配置文件格式
• 确认皮肤资源文件存在
• 删除 HsSkins.cfg 重新配置

版本号说明

HsMod采用四位版本号：

• 第一位：炉石传说主版本号
• 第二位：炉石传说在该版本的更新次数
• 第三位：HsMod新增功能次数
• 第四位：编译版本号，记录bug修复

重要注意事项

兼容性说明

• 当前仅适配BepInEx 5版本
• 可能与基于 Assembly-CSharp.dll 的修改冲突
• 建议在纯净的游戏环境中使用

安全使用提醒

• 使用官方客户端进行重要操作
• 定期检查插件更新
• 避免使用不明来源的配置文件

高级功能配置

Web服务配置

• 默认端口：58744
• 支持静态页面解析
• 根目录：Hearthstone/BepInEx/HsMod

日志文件管理

• 统计日志：BepInEx\HsMatch.log
• 可在设置中修改日志配置

通过本指南，您可以轻松安装并配置HsMod插件，享受更加个性化、高效的炉石传说游戏体验。记得在使用过程中关注官方更新，及时获取最新功能和优化。