HsMod 安装指南：基于 BepInEx 的炉石传说多功能模改插件

HsMod 安装指南基于 BepInEx 的炉石传说多功能模改插件【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsModHsMod 是一款基于 BepInEx 5.x 框架和 Harmony 热补丁技术开发的炉石传说Hearthstone模改插件以单一 DLL 形式注入游戏覆盖变速控制、界面清理、快速开包、酒馆战棋数据、皮肤定制等场景。项目采用 AGPL-3.0 协议开源支持 Windows、macOS、Linux 三个平台不收集任何用户信息仅用于学习与研究。 安装与依赖配置前置条件最新正式版炉石客户端安装路径不能包含非拉丁字符如中文BepInEx 5.x。BepInEx 6 仍处于预发布阶段HsMod 尚未适配2026-07-01 起炉石转为 64 位程序请使用 x64 构建从源码编译需要 .NET SDK 8.x插件不收集任何数据但需注意与其他修改Assembly-CSharp.dll的模组可能冲突见故障排查Windows 安装步骤从 Releases 下载HsMod.dll或按下面的方式从源码编译将 BepInEx x64 解压到炉石根目录Hearthstone\将项目目录 HsMod/UnstrippedCorlib/ 下的全部 DLL 复制到Hearthstone\BepInEx\unstripped_corlib\编辑Hearthstone\doorstop_config.ini[config] dll_search_path_override BepInEx\unstripped_corlib旧版本 BepInEx 的键名为dllSearchPathOverride将HsMod.dll放入Hearthstone\BepInEx\plugins\启动游戏从源码编译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。构建后的install.bat会在检测到默认炉石目录已配置 BepInEx 时自动复制 DLL。macOS 与 LinuxmacOS使用BepInEx_macos_universalDLL 来自 HsMod/UnstrippedCorlibUinx/在run_bepinex.sh中设置executable_nameHearthstone.app并以x86_64架构运行炉石目前无 arm64 版本Linux通过 0xf4b1 的hearthstone-linux方案安装客户端使用 BepInEx unix v5executable_nameBin/Hearthstone.x86_64两者都通过client.config中的登录令牌Battle.net 登录 URL 中?ST与accountId之间的部分绕过 Battle.net 启动令牌过期后游戏打不开时更新该文件即可 功能总览核心操作场景变速齿轮1~32 倍默认上限 8 倍可配置快捷键分升档、降档、复位、最大四组显示实时帧率并可修改目标帧率快速开包空格一次开 5 包可选开包时自动分解全额退尘卡支持一键分解全额退尘卡组收藏页显示卡牌真实数量9、右键查看 DbId、一键清除new!标记界面清理与对手信息移除中文提示、削弱补丁提示、广告、天梯结算奖励、游戏结束推广与奖励弹窗屏蔽对手表情可限量、屏蔽思考表情、屏蔽鲍勃语音、跳过匹配英雄介绍显示对手完整 Battle.net 昵称、传说以下天梯段位、对手已知卡牌标记可一键静音快捷键酒馆战棋场景排行榜覆盖层显示每位对手 MMR单人/双人对局开始后台加载对局统计每场排位的位置、MMR 变化、英雄写入 CSV网页按今日 / 7 天 / 月 / 全部与单人 / 双人筛选商店快捷键刷新、冻结、酒馆升级、英雄技能、双人模式队友棋盘按键可重绑仅购物阶段生效开局自动屏蔽所有对手表情默认关闭、快速战斗跳过部分动画自动化与 AFK 场景VerifyWebCredentials登录支持命令行启动无需 Battle.net支持--width/--height等启动参数禁用掉线检测允许长时间无操作挂机自动收取竞技场、对决、佣兵等奖励并打开奖励包、自动举报对手、自动轮换卡组、观战时自动切换视角屏蔽错误报告不向暴雪发送错误信息或选择允许报告并自动退出个性化与开发者场景皮肤匹配/酒馆英雄皮肤、终结动画、面板、幸运硬币、卡背、自动金卡/钻卡、佣兵随机皮肤模拟开包随机或固定结果可指定类型、数量、稀有度、模拟拔线断连、访问炉石开发者模式Showinfo 网页显示佣兵进度、开包历史等信息默认端口 58744/shellWebShell 需手动启用 重点功能深讲变速齿轮系统做什么统一控制游戏内动画与流程速度负值减速、正值加速默认档位在 -8 ~ 8 之间循环上限可配置到 32怎么用在配置中开启isTimeGearEnable通过四组可重绑快捷键升档/降档/复位/最大挂机模板AFK 模板下齿轮会自动置零注意事项高速档位适合开包、日常任务与观战回放对局中保持 1 倍速度避免操作变形。相关配置项为timeGearMain.cs 中的快捷键分发逻辑酒馆战棋数据与快捷键做什么在战棋排行榜上叠加对手 MMR并将每场排位的位置、MMR 变化、英雄记录到会话统计怎么用开启isBgRankEnable与isBgSessionStatsEnable日志写入BepInEx\HsMatch.log逗号分隔 CSV配置页提供时间范围与模式筛选图表注意事项MMR 数据在对局开始时后台加载首次显示可能略有延迟快速战斗功能在佣兵 PvE 中同样可用但最终死亡结算可能滞后皮肤定制做什么修改匹配/酒馆英雄皮肤、终结动画、匹配与酒馆面板、幸运硬币、卡背以及金卡/钻卡表现怎么用编辑HsSkins.cfg首次运行自动生成或在游戏内 Mod Settings 中修改对局中更新时按F4保存皮肤配置再触发模拟断线使新皮肤生效。卡背类修改在局内自动生效注意事项F4是固定快捷键同时会转储游戏内信息到Hearthstone\BepInEx\并重启 Web 服务皮肤显示异常时先核对HsSkins.cfg无效则删除HsMod.cfg重新配置⚙️ 配置文件说明文件位置说明HsMod.cfgHearthstone\BepInEx\config\主配置含全部功能开关与快捷键首次运行自动生成HsSkins.cfgHearthstone\BepInEx\config\皮肤配置首次运行自动生成HsMatch.logHearthstone\BepInEx\战棋会话统计CSV 格式路径可在设置中改client.config与Hearthstone.exe同级绕过 Battle.net 的令牌登录配置大部分功能默认关闭需在 ModSettingsUI 对应的游戏内菜单Esc → Mod Settings带分类、搜索与按键录制或 Web 配置页http://localhost:58744/config中逐项启用。改动一般即时生效无需重启例外是对局中的皮肤更新需要F4保存 模拟断线。client.config示例[Config] Version 3 [Aurora] VerifyWebCredentials TOKEN ClientCheck 0 Env.Override 1 Env us.actual.battle.netEnv按区域填写国服为cn.actual.battlenet.com.cn其余与令牌前两位一致。启用插件后也可直接用./Hearthstone.exe VerifyWebCredentials命令行启动。 架构速览HsMod/ ├── Main.cs # 插件入口参数解析、快捷键分发、F4 处理 ├── PluginConfig.cs # 全部配置项定义 ├── Patcher.cs # Harmony 补丁统一注册与卸载 ├── Patches/ # 按玩法拆分的补丁模块战棋/佣兵/盒子/反作弊等 20 文件 ├── Utils*.cs # 通用工具皮肤、假宠物、命令行参数、开包 ├── Bg*.cs # 酒馆战棋MMR 覆盖层、会话统计、自动静默 ├── WebServer.cs / WebApi.cs / WebPage.cs # 内置 Web 服务与配置页 ├── Languages/ # 16 种语言 JSON作为嵌入资源随 DLL 编译 ├── WebResources/ # 配置页与展示页 HTML 模板 └── UnstrippedCorlib(Uinx)/ # 未剥离 PDB 的运行库Windows / Unix 各一套设计思路每个玩法对应一个独立补丁类由 Patcher.cs 集中注册互不干扰多语言与网页资源以嵌入资源形式编译进HsMod.dll部署只需一个文件Web 服务与游戏进程同生命周期F4可重启。版本号采用四段式当前如12.1.0.1第一段对应炉石大版本第二段为该版本内炉石更新次数第三段为 HsMod 功能更新次数第四段为编译bug 修复版本。炉石更新不必然导致 HsMod 失效插件仍可用时无需强制升级。 使用技巧与调优几乎全部功能默认关闭按需启用即可减少潜在冲突与日志噪音变速档位建议开包与日常任务 8 倍动画跳过最高 32 倍对局回放保持 1 倍Web 服务默认监听所有本地 IP 且端口为 58744云服务器部署时务必收紧防火墙与安全组快捷键默认在聊天等文本输入激活时自动禁用避免打字误触发酒馆商店快捷键仅购物阶段生效出问题先删除对应.cfg通常在BepInEx\config\重新配置仍无法解决再附HsMod.cfg反馈 常见故障排查插件无法加载检查炉石安装路径是否含中文或其他非拉丁字符确认 BepInEx 为 5.x 的 x64 版本非 6.x 预览版unstripped_corlib下 DLL 完整核对doorstop_config.ini中dll_search_path_override是否指向BepInEx\unstripped_corlib皮肤修改不生效核对HsSkins.cfg中的皮肤 ID 是否存在对局中按F4保存后模拟断线删除HsMod.cfg重新配置Web 配置页无法访问防火墙放行端口 58744确认游戏已启动且插件加载成功尝试更换浏览器或用启动参数--port指定其他端口与其他模组冲突检查是否有其他基于Assembly-CSharp.dll的模组在修改 IL会导致补丁偏移错位两个 BepInEx 插件同时补丁同一方法也会失效HsMod 不检测原方法是否已被修改建议排查后禁用其中一个设置无法保存检查是否同时启用了其他炉石插件删除HsMod.cfg后重新进入 Mod Settings 配置⚠️ 安全与合规提示中国大陆炉石客户端默认启动反作弊 SDKHsMod 会尝试屏蔽相关功能但不能保证账号安全建议在非排位、非官方比赛的休闲场景中测试避免在正式赛事中使用插件不收集任何用户信息遵循 AGPL-3.0定位是学习与研究用途/shellWebShell 权限很高必须手动启用且该端口绝不应暴露到公网 社区与贡献项目遵循 AGPL-3.0 协议开发活动在上游仓库 Pik-4/HsMod 进行问题反馈提交 Issue附HsMod.cfg便于定位功能开发修复补丁、新增玩法支持提交 PR翻译编辑 HsMod/Languages/ 下对应语言 JSON当前覆盖 zhCN、enUS、jaJP、koKR、ruRU 等 16 种重新编译后提交社区讨论Telegram 群组 HearthstoneMod 与官方 Discord 服务器结语HsMod 把炉石玩家日常重复、低效的操作——开包、收集奖励、战棋商店、界面提示——收敛到一套可配置的开关与快捷键里同时保留了皮肤与开发者工具这类深度定制入口是 BepInEx 生态中功能面较宽的炉石插件之一。如果你受够了冗长动画和满屏提示可以从安装 BepInEx 5.x、放置HsMod.dll这两步开始进游戏后按 Esc 进入 Mod Settings 逐项打开需要的功能。【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsMod创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考