启动模组加载器

启动模组加载器

在2026-10-20更新后启动Lua模组:PUC Lua 5.1,无ffi

Boot Mod Loader

Lua 模组在 2026 年 10 月 20 日的游戏更新(切换到 Easy Anti-Cheat)后停止工作。此加载器让它们重新启动。

那次更新发生了什么

  • 游戏现在运行内置的 PUC-Rio Lua 5.1。LuaJIT 已移除,[b]ffi[/b]、[b]bit[/b] 和 [b]jit[/b] 也随之消失。
  • Bingus Shared Loader 启动的脚本(core/wwise/lua/wwise_flow_callbacks)已从游戏中移除,因此没有基于加载器的 Lua 模组能启动。
  • 游戏仍然从模组加载其 boot 脚本,并且仍然每帧运行 Lua 模组的更新。这就是此加载器所利用的。

它的作用

  • 它替换游戏的 boot 脚本,并首先原样运行原始脚本。
  • 然后启动每一个以 Bingus Shared Loader 方式声明自己的 Lua 模组:第一行为 -- HD2-Addon: mods/<author>/<name>。为 Bingus Shared Loader 构建的模组无需修改即可被找到。
  • 每个模组独立启动。失败的模组会被跳过,其余模组仍会启动。
  • 日志会告诉你它找到了哪些模组、哪些启动了、哪些失败了以及原因:%APPDATA%\Arrowhead\Helldivers2\boot_mod_loader.log

安装

  • 像安装其他模组一样,用你的模组管理器安装它。它没有设置项。
  • 只有一个模组可以替换 boot 脚本。 不要安装第二个同样替换它的加载器。
  • Bingus Shared Loader v20 在此游戏版本上无法启动,因此你不需要将它与此加载器一起使用。

哪些模组会工作

加载器只负责启动模组。它无法恢复游戏已移除的内容。

  • 可用:仅使用游戏 Lua API 的模组,这些 API 仍然存在:单位、灯光、线条、屏幕文本、按键以及游戏的网络字段。在此游戏版本上测试过:Mod Lag Watchdog、Helmet Headlamp。
  • 不可用:需要 LuaJIT 的模组。这意味着 [b]ffi[/b](所有读取或写入游戏内存的模组)、[b]bit[/b] 库、[b]goto[/b] 或 LuaJIT 字节码。日志会列出每一个及其失败原因。
  • 有些模组可以部分工作。例如,模组可能在关闭其内存读取部分的情况下仍能运行。

致模组作者

  • 你的模组必须是 9ba626afa44a3aa3.patch_<n> 中的纯文本 Lua 资源。其资源名必须为 mods/<author>/<name>,且第一行必须为 -- HD2-Addon: mods/<author>/<name>。
  • 如果两个补丁携带相同名称,补丁编号最高的胜出。模组按补丁顺序在引擎的 init 内启动。此时 update 和 shutdown 已存在且可被包装。
  • 提供不带 ffi 的 CowboyBingusModLoader:api、open_log、after_startup 和 capabilities。其 revision 指明了此加载器。
  • 为 Lua 5.1 编写。不要使用 goto、bit.*、0x...ULL 或 ffi。针对 PUC Lua 5.1 进行测试;[url=https://github.com/pat-pat-patrick/boot-mod-loader]仓库[/url]展示了如何操作。

源码与许可

源码在 GitHub 上:[url=https://github.com/pat-pat-patrick/boot-mod-loader]pat-pat-patrick/boot-mod-loader[/url],采用 MIT 许可。游戏自身的 boot 脚本不在仓库中:构建时会从你自己的安装中获取。

致谢:-- HD2-Addon: 约定和加载器 API 来自 CowboyBingus 的 [url=https://github.com/CowboyBingus/BingusSharedLoader]Bingus Shared Loader[/url]。此加载器是针对当前游戏的独立实现,不包含其任何代码。

我的其他模组 [url=https://www.nexusmods.com/helldivers2/mods/16735][b]Mod Lag Watchdog[/b][/url] [url=https://www.nexusmods.com/helldivers2/mods/17095][b]Where's My Shit[/b][/url] [url=https://www.nexusmods.com/helldivers2/mods/16320][b]Helmet Headlamp[/b][/url] [url=https://www.nexusmods.com/helldivers2/mods/16662][b]Super Laser Sights Plus[/b][/url] [url=https://www.nexusmods.com/helldivers2/mods/16504][b]Super Laser Sights for Turrets and Drones[/b][/url] [url=https://www.nexusmods.com/helldivers2/mods/16821][b]Super Clear Menu[/b][/url]

[url=https://ko-fi.com/vegansquid][img width=500]https://i.ibb.co/TMfqRBXS/kofi-banner.png[/img][/url]