HsMod炉石插件:三步装好,60+功能随心开启
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
HsMod 是一款基于 BepInEx 注入框架(一种在游戏启动时加载外部 dll 的模组工具)的炉石传说增强插件,提供英雄皮肤定制、对战加速、奖励自动领取、对手信息显示等能力。如果你想让界面更清爽、对局节奏更快、日常事务自动完成,这篇教程会带你从安装到配置一次走完。
一分钟看懂
HsMod 通过注入炉石客户端生效,所有功能都是独立开关,默认关闭,你只用打开需要的那几项。项目不收集任何用户信息,代码完全公开,行为可以自行核对。
- 60 余项功能,覆盖酒馆战棋、界面体验、自动化、对手信息、皮肤五大方向
- 支持 Windows、macOS、Linux 三个平台
- AGPL-3.0 开源协议,基于 BepInEx 5 开发,使用 .NET 8 编译
- 内置 Web 配置界面,支持 12 种语言,修改实时生效
- 默认 Web 服务端口 58744,可查看佣兵进度、开包历史等信息
功能详解
休闲玩家:界面清理与外观定制
- 皮肤与外观:英雄皮肤、卡背、卡牌镀金/钻石效果都可按喜好配置,让对战画面变成自己的风格
- 界面清理:屏蔽「无法匹配」弹窗、广告、升级提示等,减少打断
- 齿轮加速:默认最高 8 倍速,可配置到 32 倍,长局等待动画不再拖时间
- 静音快捷键:一键静音游戏,边办公边开把战棋也不吵
- 收藏卡牌数显示:原本显示「9+」的位置改为显示真实张数
硬核玩家:对战信息与数据统计
- 对手信息:显示完整战网昵称、传说以下天梯等级,并标记对手已暴露的卡牌
- MMR 显示:酒馆战棋排行榜下显示每位玩家的 MMR,开局后台加载
- 对局统计:名次、MMR 变化、所用英雄按局写入 CSV,并支持按今天/7 天/月度/全部筛选查看
- 商店快捷键:酒馆阶段的刷新、冻结、酒馆升级均可按键触发,支持改键,仅购物阶段生效
- 日志记录:对战数据写入
BepInEx\HsMatch.log,方便赛后复盘
进阶与开发者:自动化与调试
- 开发者模式:启用游戏自带开发者选项,右键卡牌可查看 DbId(卡牌数据库 ID)
- 自动化:竞技场、对决、佣兵奖励自动领取;空格一次开 5 包,可选自动分解全额返尘卡
- 模拟功能:模拟开包结果、模拟断线、用金币购买指定冒险内容
- 绕过客户端启动:配置 client.config 后不依赖战网客户端直接进入游戏
- Web 服务:内置信息显示页面,还可开启 Webshell,界面源码见 WebResources/
⚡ 快速上手
以 Windows 为例,全程 5 步;macOS 和 Linux 改为使用 BepInEx 的 unix 版本,第 2 步换成UnstrippedCorlibUnix目录,其余步骤相同。
- 将 BepInEx 5 x64 版解压到炉石根目录
- 创建
BepInEx\unstripped_corlib\,把项目里 UnstrippedCorlib/ 的全部 dll 复制进去 - 编辑
doorstop_config.ini,设置dll_search_path_override = BepInEx\unstripped_corlib - 把 HsMod.dll(从 Releases 下载或自行编译)放入
BepInEx\plugins - 启动游戏,按 Esc 打开「Mod Settings」,开启需要的功能
需要自己编译时,在仓库目录执行dotnet build --configuration Release --no-restore(需 .NET 8),产物在HsMod/Release/。
配置与定制
常用入口有三个,按习惯选:
- 游戏内菜单:Esc 或右上角齿轮 →「Mod Settings」,支持分类、搜索和按键捕获,最常用
- Web 配置页:运行后访问
http://localhost:58744/config,多语言切换,改动实时生效 - 皮肤配置文件:
Hearthstone\BepInEx\config\HsSkins.cfg,首次运行自动创建,键值对格式;对局中按F4(固定快捷键)保存并更新皮肤配置
F4 同时负责导出部分游戏信息、重启 Web 服务;其余快捷键都可在 Mod Settings 里改键。
注意事项与排错
- 账号风险:中国大陆炉石客户端默认启动反作弊 SDK,HsMod 会尝试屏蔽相关功能,但项目方不保证账号安全,启用前请自行评估
- 路径要求:炉石安装路径不能包含中文或其他非拉丁字符,否则注入可能失败
- 版本兼容:目前适配 BepInEx 5,BepInEx 6 仍为预览版暂不支持;2026-07-01 起炉石改为 64 位,必须使用 x64 版本
- 冲突规避:不要与其他修改
Assembly-CSharp.dll的模组同用,IL 偏移错位会导致补丁失效;配置保存不上时,检查是否有其他 BepInEx 插件在运行
常见问题
Q:炉石更新后插件还能用吗?不一定失效。功能照常可用就不需要跟版更新,可对照 Release 说明确认是否有功能调整。
Q:装完游戏无法启动怎么办?先核对 unstripped_corlib 的 dll 是否复制齐全、doorstop_config.ini 是否改对,再到 BepInEx 日志里找具体报错。
Q:快捷键在哪里设置,配置存在哪里?除固定的 F4 外均可在 Mod Settings 改键;配置保存在BepInEx\config\,主配置为 HsMod.cfg。
Q:皮肤显示异常怎么处理?检查 HsSkins.cfg 中的取值是否有误;仍不行就删除 HsMod.cfg 重新配置,再重启游戏。
以上内容覆盖了 HsMod 的安装、常用配置和值得优先开启的功能。完整功能清单与各平台详细步骤见项目说明 ReadMe.md;若想做二次开发,各功能的补丁实现都集中在 Patches/ 目录,可对照源码逐个阅读。
【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考