HsMod 炉石插件完整指南：批量开包、32 倍变速与 BepInEx 5 部署

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

HsMod 炉石插件是一款基于 BepInEx 5 框架的炉石传说修改工具，源码遵循 AGPL-3.0 协议。它通过 Harmony 热补丁在不改动游戏核心文件的前提下，提供批量开包、32 倍变速、对手情报、皮肤替换与内置 Web 数据服务等 50 余项能力，适合追求集卡效率、对战信息与界面自定义的玩家。

📌 项目快照

🎁 开箱与集卡环节

按空格键一次开 5 个卡包。开启isQuickPackOpeningEnable后，批量开包自动跳过动画，把几分钟的拆包压缩到几秒。

分解可全返还卡牌。isAutoRefundCardDisenchantEnable默认关闭、需手动开启，开包时即时分解冗余卡牌，省去逐张点击。

显示收藏 9+ 卡牌的实际数量。isShowCardLargeCount把"9+"替换为真实持有数，方便核对进度。

右键卡牌查看 DbId。isShowCollectionCardIdEnable在收藏、英雄、卡背、酒馆面板等位置显示内部 DbId，便于对照替换。

一键清除新卡标记。按 Ctrl+R 批量去掉收藏界面的new!角标，需重新进入收藏界面生效。

⚔️ 对战与酒馆战棋环节

显示对手天梯等级。isOpponentRankInGameShow在传奇以下段位展示对手段位，仅排名模式生效。

标记对手已知卡牌。isCardTrackerEnable高亮你能确定的对手手牌，辅助预判。

无冷却发送表情。数字键 1–6 直接触发问候、赞赏、感谢等表情，最小间隔 1.5 秒；receiveEnemyEmoteLimit限制接收对手表情次数，设 0 即完全屏蔽。

加速对战节奏。开启isQuickModeEnable跳过部分对战动画，比变速齿轮更顺滑，对酒馆战棋和佣兵 PvE 同样有效。

叠加战棋情报。isBgRankEnable在排行榜名字下显示对手 MMR；isBgSessionStatsEnable把每局排名、分差、英雄写入 CSV 并绘制今日 / 7 天 / 本月图表；商店快捷键 R 刷新、F 冻结、U 升级、H 英雄技能、T 切换队友棋盘（双人）。

🖥️ 界面日常与皮肤

打开游戏内 Mod 设置菜单。按 Esc 或点击齿轮图标进入 Mod Settings，支持分类、搜索与键位录制；按钮可隐藏。

调节变速齿轮。timeGear取值 -32 到 32，方向键执行上调 / 下调 / 归零 / 最高（键盘最高 8 倍），配置文件可拉到 32 倍。

监控与锁定帧率。isShowFPSEnable叠加显示 FPS（Ctrl+P 切换）；targetFrameRate写入目标帧率，-1 表示跟随游戏默认。

屏蔽弹窗与提示。isAlertPopupShow拦截"无法匹配"等弹窗；插件同时移除中国提示、nerf 补丁提示、广告、天梯结算与成就奖励横幅。

替换皮肤。编辑BepInEx\config\HsSkins.cfg或在设置里修改英雄、卡背、战场、幸运币（skinCoin）、终结效果等 DbId；对局中按 F4 保存并模拟拔线立即生效。

🚀 部署链路：BepInEx 5 环境搭建

环境要求。炉石安装路径不能含非拉丁字符；2026-07-01 起客户端转为 64 位，务必用 BepInEx x64 版本。

编译插件。使用 .NET SDK 8.x：

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。PostBuild 步骤 install.bat 会在已配置 BepInEx 的默认安装目录自动拷贝该 dll。

放置 BepInEx。下载 BepInEx x64 解压到炉石根目录，把仓库HsMod/UnstrippedCorlib下所有 dll 拷入Hearthstone\BepInEx\unstripped_corlib\（macOS / Linux 改用UnstrippedCorlibUnix）。

配置 DoorStop。编辑Hearthstone\doorstop_config.ini：

# BepInEx 5.4.23.2+ 使用下划线写法 dll_search_path_override = BepInEx\unstripped_corlib # 旧版 BepInEx 改为下： # dllSearchPathOverride=BepInEx\unstripped_corlib

放入插件并启动。把HsMod.dll复制到Hearthstone\BepInEx\plugins，启动游戏。

验证成功。检查三点：BepInEx 控制台打印Plugin HsMod is loaded!；Esc 菜单出现 Mod Settings 按钮；按 F4 屏幕弹出补丁数量与插件状态。

🎛️ 两套配置组合

配置文件是BepInEx\config\HsMod.cfg。两种典型用途：

# 快速集卡向 isQuickPackOpeningEnable = true # 空格一次开 5 包 isAutoRefundCardDisenchantEnable = true # 开包时自动分解（需手动开） isShowCardLargeCount = true # 显示 9+ 实际数量 isShowCollectionCardIdEnable = true # 右键显示 DbId webServerPort = 58744 # Web 开包记录端口

# 对战信息向 isOpponentRankInGameShow = true # 对手天梯等级 isFullnameShow = true # 对手完整昵称 isCardTrackerEnable = true # 标记对手已知牌 isSkipHeroIntro = true # 跳过英雄介绍 receiveEnemyEmoteLimit = 3 # 限制接收表情次数

🔧 进阶：性能、Web 服务与快捷键

性能参数。isShowFPSEnable+targetFrameRate控制帧率；isPatchAssetLoader优化资源加载；isSkipHeroIntro跳过入场动画。

内置 Web 服务。默认端口 58744，监听所有本地 IP。常用路径：/pack开包历史、/collection收藏、/matchlog对局日志、/alive运行状态、/config在线改配置；/shell需手动启用。

自定义快捷键。在HsMod.cfg的快捷键段落重绑定；F4 固定用于 dump 信息、更新皮肤配置、重启 Web 服务，不可改。

常见问题（现象 → 检查项）：

• 插件加载但功能不生效 → 检查HsMod.cfg的isPluginEnable是否为 true；删除.cfg重新生成。
• 皮肤显示不正确 → 核对HsSkins.cfg的 DbId；删除HsMod.cfg重配。
• 改的配置不保存 → 排查是否启用了其它炉石插件。
• Web 服务无法访问 → 确认webServerPort未被占用，检查本机防火墙。

⚠️ 中国大陆炉石客户端默认启用反作弊 SDK。HsMod 会尝试屏蔽相关检测，但无法保证账号安全。建议仅在非排名模式使用，并自行承担使用风险。

HsMod 把集卡、对战、界面、后台四类高频操作收进一个 BepInEx 5 插件，部署一次即可按需开关。先从部署链路与一套配置组合跑通，再按你的场景裁剪功能。核心实现可参考 核心配置文件、皮肤管理系统 与 Web 服务。

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