HsMod炉石插件完整使用指南：从安装到高级功能详解

HsMod是一款基于BepInEx框架开发的炉石传说功能增强插件，为玩家提供游戏加速、登录优化、界面定制等实用功能。本指南将详细介绍HsMod的安装配置和各项功能的使用方法。

项目概述

HsMod（Hearthstone Modification）是一个开源插件项目，基于AGPL-3.0协议发布，仅供学习和研究使用。该插件不会收集任何用户信息，确保使用安全。

环境准备与安装

系统要求

• .NET SDK 8.x 环境
• 支持Windows、macOS和Linux系统
• 炉石传说游戏客户端

源码编译安装

首先克隆项目仓库并编译插件：

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_x86并解压到炉石传说根目录
2. 创建目录 Hearthstone\BepInEx\unstripped_corlib\
3. 将项目目录 HsMod/UnstrippedCorlib 下的所有dll文件复制到unstripped_corlib目录
4. 修改 doorstop_config.ini 文件，设置 dllSearchPathOverride=BepInEx\unstripped_corlib
5. 将 HsMod.dll 放置在 Hearthstone\BepInEx\plugins 目录

macOS系统安装步骤

1. 下载BepInEx_macos_x64并解压到Hearthstone目录
2. 复制项目文件夹 HsMod/UnstrippedCorlibUnix 下的所有dll文件到相应目录
3. 编辑 run_bepinex.sh 文件，修改相关配置
4. 给脚本添加执行权限：chmod u+x run_bepinex.sh
5. 获取登录令牌并配置client.config文件

Linux系统安装步骤

1. 参考hearthstone-linux项目安装炉石传说
2. 下载BepInEx_unix并解压到游戏根目录
3. 创建unstripped_corlib目录并复制相应dll文件
4. 修改运行脚本配置参数
5. 配置client.config文件

核心功能详解

游戏加速功能

HsMod支持最高32倍游戏加速，大幅缩短对战等待时间。该功能支持智能调节，可根据对战阶段自动调整速度，避免影响操作体验。

登录优化功能

通过配置client.config文件，玩家可以绕过战网客户端，使用令牌直接登录游戏。配置示例如下：

[Config]
Version = 3
[Aurora]
VerifyWebCredentials = "你的登录令牌"
ClientCheck = 0
Env.Override = 1
Env = cn.actual.battlenet.com.cn

界面定制功能

• 移除窗口大小限制，支持自由调整窗口尺寸
• 自定义英雄皮肤、卡背和终结特效
• 屏蔽各种弹窗提示，包括错误提示、奖励提示等

卡牌管理功能

• 自动分解多余卡牌
• 快速开启卡包，支持空格键一次开启5包
• 显示收藏中卡牌的实际数量（9+）

高级功能应用

Web管理界面

HsMod内置了强大的Web管理功能，默认访问地址为 http://localhost:58744/shell.html。通过浏览器界面，玩家可以：

• 实时查看游戏状态信息
• 执行管理命令和配置调整
• 监控插件运行状态

快捷键配置

• F4键：更新皮肤配置并重启Web服务
• 自定义组合键：根据个人习惯设置专属快捷键
• 场景化快捷键：为不同游戏模式配置专用快捷键

皮肤定制系统

皮肤配置文件位于 Hearthstone\BepInEx\config\HsSkins.cfg，支持修改：

• 英雄皮肤
• 卡背图案
• 终结特效
• 幸运硬币等

配置说明

client.config配置

该文件用于绕过战网客户端直接启动游戏，需要放置在Hearthstone.exe所在目录。

多语言支持

项目提供完善的多语言支持，语言文件位于Languages目录。目前支持简体中文、英文、德语、法语、日语、韩语等多种语言。

插件配置管理

大多数插件功能需要在配置中手动启用，配置文件通常位于 BepInEx\config\ 目录。

常见问题解决

功能不生效问题

1. 按F4键刷新皮肤配置
2. 检查文件路径是否正确
3. 验证权限设置是否适当

Web服务访问问题

1. 确认防火墙设置，确保58744端口开放
2. 检查插件是否已正确启用Web功能
3. 验证游戏是否正常运行

插件冲突处理

HsMod可能与修改 Assembly-CSharp.dll 的其他插件产生冲突。建议：

• 只保留必要的功能插件
• 按需启用HsMod的各个模块
• 定期检查插件兼容性

版本说明

HsMod版本号采用四段式格式：

• 第一位：炉石传说主版本号对应
• 第二位：炉石传说在该版本中更新次数（不直接对应小版本号）
• 第三位：HsMod新增功能次数
• 第四位：编译版本号，主要用于记录bug修复

注意事项

1. 插件安装路径不能包含中文字符
2. 可能与其他修改Assembly-CSharp.dll的插件冲突
3. 默认情况下，几乎所有插件功能都需要手动启用
4. 皮肤显示异常时，检查HsSkins.cfg配置文件
5. 建议使用BepInEx 5版本

最佳实践

配置备份策略

定期备份以下重要文件：

• HsMod配置文件
• 皮肤定制文件
• 登录令牌信息

版本更新指南

当炉石传说版本更新时：

1. 先尝试删除配置文件重新生成
2. 检查插件功能是否正常
3. 如有问题，等待插件更新版本

通过本指南，玩家可以充分利用HsMod的各项功能，提升炉石传说的游戏体验。请合理使用插件功能，遵守游戏规则，享受个性化的游戏乐趣。