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

HsMod 教程BepInEx 炉石插件 3 步装完50 开关全解【免费下载链接】HsModHearthstone Modification Based on BepInEx项目地址: https://gitcode.com/GitHub_Trending/hs/HsModHsMod 是跑在 BepInEx 5 框架上的炉石传说修改插件把动画提速、空格开包、自动领奖、皮肤替换、对局统计这些高频动作聚合进一个插件50 多项开关彼此独立。总开关默认开启具体功能默认基本全关装完后游戏内按Esc在菜单里点Mod Settings就能一屏管理所有设置。先判断要不要装适合日常开包、挂机刷金币/经验、换皮肤、看酒馆战棋对手数据、嫌结算动画慢的人。不适合期望全自动代打的人——它只替你省点击和等待不做决策。硬限制Windows / macOS / Linux 三平台支持安装路径必须是纯拉丁字符macOS 客户端目前只能跑 x86_64arm64 暂不可用。账号风险插件本身不收集任何信息但它修改了客户端行为官服使用后果自负。动手前核对条件要求判断标准BepInEx5 系 x64 版6 系仍是预发布未适配2026-07-01 起客户端为 64 位解压后炉石根目录出现BepInEx\plugins\安装路径不含中文等非拉丁字符三平台通用Hearthstone.exe完整路径全是英文与数字插件本体最新 Release 的HsMod.dll或装 .NET SDK 8.x 自行编译dotnet build成功产出HsMod.dllcorlib 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 # 更早版本 dllSearchPathOverrideBepInEx\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_nameHearthstone.app把export ARCHPREFERENCE一行换成export ARCHPREFERENCEx86_64客户端暂不支持 arm64最后chmod ux 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_nameBin/Hearthstone.x86_64然后sed -i s/\r/ /g ./run_bepinex.sh修掉换行符chmod ux后./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 端口。挂机启动参数启动命令加afk1直接套用挂机模板插件 齿轮 自动领奖 快速开包 禁掉线afk4是反挂机模板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），仅供参考