☰
HsMod 教程:BepInEx 炉石插件 3 步装完,50+ 开关全解
2026/11/4 11:56:36 网站建设 项目流程

HsMod 教程:BepInEx 炉石插件 3 步装完,50+ 开关全解

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

HsMod 是跑在 BepInEx 5 框架上的炉石传说修改插件,把动画提速、空格开包、自动领奖、皮肤替换、对局统计这些高频动作聚合进一个插件,50 多项开关彼此独立。总开关默认开启,具体功能默认基本全关,装完后游戏内按Esc,在菜单里点Mod Settings就能一屏管理所有设置。

先判断要不要装

  • 适合:日常开包、挂机刷金币/经验、换皮肤、看酒馆战棋对手数据、嫌结算动画慢的人。
  • 不适合:期望"全自动代打"的人——它只替你省点击和等待,不做决策。
  • 硬限制:Windows / macOS / Linux 三平台支持;安装路径必须是纯拉丁字符;macOS 客户端目前只能跑 x86_64,arm64 暂不可用。
  • 账号风险:插件本身不收集任何信息,但它修改了客户端行为,官服使用后果自负。

动手前核对

条件要求判断标准
BepInEx5 系 x64 版(6 系仍是预发布,未适配;2026-07-01 起客户端为 64 位)解压后炉石根目录出现BepInEx\plugins\
安装路径不含中文等非拉丁字符,三平台通用Hearthstone.exe完整路径全是英文与数字
插件本体最新 Release 的HsMod.dll,或装 .NET SDK 8.x 自行编译dotnet build成功产出HsMod.dll
corlib DLLWindows 用 HsMod/UnstrippedCorlib/,macOS/Linux 用 HsMod/UnstrippedCorlibUnix/DLL 全部进入BepInEx\unstripped_corlib\,这组文件补全了调试符号,BepInEx 加载插件依赖它

安装流程

Windows 主线

# 1. 把 BepInEx x64 压缩包解压到炉石客户端根目录( Hearthstone\ ) # 2. 建 Hearthstone\BepInEx\unstripped_corlib\, # 把项目 HsMod/UnstrippedCorlib 下的全部 DLL 拷进去 # 3. 编辑炉石根目录 doorstop_config.ini: # BepInEx 5.4.23.2 及以后: dll_search_path_override = BepInEx\unstripped_corlib # 更早版本: dllSearchPathOverride=BepInEx\unstripped_corlib # 4. HsMod.dll 放进 Hearthstone\BepInEx\plugins\ # 5. 启动游戏,按 Esc 看到 Mod Settings 按钮即装好

最容易翻车的是路径里有非拉丁字符、BepInEx 装成 x86,这两处各查一遍。

想自己编译?装好 .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.dll放进BepInEx\plugins\即可;HsMod/install.bat 能自动把它拷到默认安装目录(前提是该目录已配好 BepInEx)。

macOS 差异

换 Unix 版 corlib:用 HsMod/UnstrippedCorlibUnix/ 的 DLL,拷到/Applications/Hearthstone/BepInEx/unstripped_corlib/,Mono 和 Unity 版本需与客户端匹配。

run_bepinex.sh改三处:executable_name="Hearthstone.app";把export ARCHPREFERENCE一行换成export ARCHPREFERENCE="x86_64"(客户端暂不支持 arm64);最后chmod u+x run_bepinex.sh。

token 登录:打开战网登录链接,截取http://localhost:0/?ST=之后、&accountId=之前的那串,用./run_bepinex.sh TOKEN启动;在炉石根目录放一份client.config存住 token 后,直接./run_bepinex.sh即可长期绕过战网启动器。

Linux 差异

先装客户端:通过 hearthstone-linux 项目装好客户端(通常已替你建好client.config),再解压 BepInEx Unix 版到炉石根目录。

修脚本再启动:run_bepinex.sh里设DOORSTOP_CORLIB_OVERRIDE_PATH="$BASEDIR/BepInEx/unstripped_corlib"和executable_name="Bin/Hearthstone.x86_64",然后sed -i "s/\r/ /g" ./run_bepinex.sh修掉换行符,chmod u+x后./run_bepinex.sh。没有client.config就按 macOS 一节补 token。

功能按场景挑

原则先说:挑 5 个以内就够,全开容易打架,真出问题也难定位是哪一项。总开关默认已开,勾需要的即可。

日常:提速与省操作

  • 齿轮加速:开包、结算等动画直接快进,默认关;方向键上下调档(档位范围 -32 ~ 32,常规上限 8 倍),左箭头复位、右箭头拉满。
  • 快速战斗(Quick Mode):跳过部分战斗动画,比齿轮更顺,开时自动屏蔽终结特效,酒馆里佣兵 PvE 也能用。
  • 空格一键开包:一次开 5 包;可勾"开包时自动分解全额返尘卡",注意该选项每次启动都会被强制关闭,用的时候要重新勾。
  • 自动领奖:竞技场、对决、佣兵结束自动点开奖励包裹。
  • 弹窗批量屏蔽:匹配失败、削卡提示、广告、天梯结算与战令奖励提示一并拦掉。
  • 帧率与焦点:显示 FPS、锁定帧率、解除窗口焦点和缩放限制,切出去看网页游戏不停帧。

对局中:对手情报与酒馆快捷键

  • 完整昵称 + 前天梯段位:进场先摸底;段位显示仅在 ranked 对局生效。
  • 标记对手已知卡牌:对手展示过的牌持续标注,相当于随身战术笔记本。
  • 酒馆对手 MMR:排行榜每名下方面板显示 MMR,开局后台加载,默认开;配套对局统计(名次、分段变化、英雄)记入 CSV,图表支持今日 / 7 天 / 月 / 全部过滤。
  • 酒馆商店快捷键:R 刷新 / F 冻结 / U 酒馆升级 / H 英雄技能 / T 队友棋盘(双人),仅购物阶段生效,全部可重绑。
  • 头像取昵称 + 加好友:点酒馆玩家头像取 battle tag;匹配中一键把对手加进好友。

进阶折腾:皮肤、Web 服务与模拟

  • 皮肤系统:对战/酒馆英雄、卡背、幸运币、匹配与酒馆面板等,改HsSkins.cfg(首次运行自动在BepInEx\config\生成)或在设置里改;对局中改完按F4保存并模拟断线当场生效,F4是固定键位不可改。
  • Showinfo Web 服务:设置里启用后浏览器访问http://localhost:58744,看佣兵养成进度、开包历史;/shell路径可执行命令、调配置,必须单独启用,放云服务器记得放行 58744 端口。
  • 挂机启动参数:启动命令加afk=1直接套用挂机模板(插件 + 齿轮 + 自动领奖 + 快速开包 + 禁掉线),afk=4是反挂机模板,0/2/3 为中间状态;另有port、width、height等参数可调分辨率与服务端口。
  • 模拟系列:模拟开包(自定义卡包类型、数量、稀有度)、模拟 iOS/Android 设备领专属卡背(可能要打一局匹配)、金币直购纳克萨玛斯/黑石山/探险者协会等冒险;卡拉赞支持强开,但序章打不了。
  • 防掉线 + 定时退出:允许长时间无操作不掉线;设了定时退出后到点自动关游戏。

问题速查

问:装了没反应,菜单里没有 Mod Settings?→ 症状:启动日志无加载记录 → 最可能原因:路径含非拉丁字符或 DLL 位置不对 → 一行修复:换纯英文路径,确认HsMod.dll在BepInEx\plugins\、unstripped_corlib完整。

问:设置改完保存不了?→ 最可能原因:其他 BepInEx 插件冲突 → 一行修复:暂时禁用其余插件再改一次。

问:皮肤不生效?→ 最可能原因:手改HsSkins.cfg漏了引号 → 一行修复:删掉HsMod.cfg重新生成,进游戏按F4。

问:58744 页面打不开?→ 最可能原因:Showinfo 没启用或端口没放行 → 一行修复:检查设置开关;云服务器放行 58744。

问:token 启动后游戏开不了?→ 最可能原因:token 过期 → 一行修复:更新client.config里的VerifyWebCredentials。

深坑一:与其他插件冲突。同时挂着其他也改Assembly-CSharp.dll的模组(如某些佣兵插件、MixMod 一类)时,同一个方法被多次补丁会让 IL 偏移对不上,HsMod 不报错但功能集体不生效。排除这类问题最快的办法:全部禁用其他插件,单独跑一遍 HsMod。

深坑二:更新后要不要重装?版本号是四段,源码当前为12.1.0.1(以仓库最新 Release 为准):第一位跟炉石主版本,第二位记该主版本内炉石更新次数,第三位记功能新增,第四位是修复编译号。实际结论只有一条:炉石更新 ≠ 插件失效。对比更新前后的核心文件(典型是Assembly-CSharp.dll),没变就接着用;变了才去拿新的HsMod.dll,别盲目追新版本。

收尾

HsMod 遵循 AGPL-3.0 协议(见 LICENSE.txt),仅用于学习研究,不收集任何用户信息。想加语言,改 HsMod/Languages/ 里的 JSON 重新编译即可;每个功能的实现都在 HsMod/Patches/ 下,Web 页面模板在 HsMod/WebResources/,构建配置是 HsMod/HsMod.csproj,顺着 ReadMe.md 读源码就能改。

最后必须说重的:国服客户端默认启用反作弊 SDK,插件会尽力屏蔽相关检测,但无法 100% 保证账号安全——值不值得用,自己掂量。大更新前把BepInEx\config\HsMod.cfg、HsSkins.cfg和对局统计日志(设置里可配路径,默认BepInEx\HsMod\match.log)各拷一份,出问题秒回滚,比什么都省事。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询