厨师共享加载器

厨师共享加载器

一个适用于所有《绝地潜兵2》模组的Lua加载器:可并行运行多个模组,具备崩溃防护与锁定机制,为每个模组的设置和按键提供游戏内选项菜单(F9),并配有性能监视器,显示每个模组每帧的开销。为Treasure Radar 0.6.0及更新版本所需;对所有模组作者开放。

[size=5][b]Chef 共享加载器[/b][/size]
[i]一个适用于所有《绝地潜兵2》模组的 Lua 加载器:并行运行、崩溃防护且锁定安全,并带有游戏内选项菜单和性能监视器。[/i]

Chef 共享加载器在当前游戏版本(Lua 5.1)上运行 Lua 模组。安装一次后,所有为其制作的模组都会彼此并行运行,各自拥有独立空间,不会争抢游戏的启动脚本。我的脚本模组(首先是 Treasure Radar)就运行在它之上,并且它对所有模组作者开放。

[b]加载顺序:将 Chef 共享加载器放在最后[/b],使其在其他所有模组之后部署(在将最高优先级列在最上方的模组管理器中,即放在最前面)。如果另一个模组在其之后部署并替换了游戏的启动脚本,则会取代其位置,届时所有 Chef 共享加载器模组都不会运行。

[size=4][b]功能[/b][/size]
[list]
[][b]所有模组并行运行:[/b]它会找到你已安装模组中的所有 Chef 共享加载器模组,并让每个模组在各自的空间中运行。当 Chef 共享加载器最后部署时,那些自行替换游戏启动脚本的模组也会运行。[/]
[][b]选项菜单(F9):[/b]一个菜单管理所有模组的设置和按键绑定,并在两次启动之间保存。它按字母顺序打开模组列表;Enter 打开某个模组的选项,< Back(或 Backspace)返回,Delete 将某项设置恢复为默认值,Escape 或 F9 关闭菜单,/ 可在所有模组中搜索。[/]
[][b]性能监视器:[/b]在菜单中开启(Chef 共享加载器 > 性能监视器)后,会显示一个面板,每秒显示一次你的帧时间以及每个模组每帧的毫秒数、占帧比例和最差时刻。关闭时无任何开销。[/]
[][b]崩溃防护:[/b]如果游戏在某个模组中崩溃,下次启动时会跳过该调用或关闭该模组,并在屏幕上提示、在日志中指明该模组,而不是再次崩溃。[/]
[][b]锁定安全:[/b]模组无法启动程序、加载原生代码或已编译的 Lua,也无法访问游戏自身文件夹之外的文件。[/]
[][b]轻量:[/b]启动时约一毫秒,空闲时每帧几乎无开销。[/]
[][b]面向模组作者:[/b]提供有文档的 API(共享设置、事件、菜单、按键绑定、安全的引擎调用、定时器、带清理的生成等)。请参阅 GitHub 上的 docs/MODDING.md。[/]
[/list]
[size=4][b]安装 / 更新[/b][/size]
[list=1]
[]模组管理器(Arsenal / HD2 Mod Manager):添加 Chef-Shared-Loader-1.0.0.zip 并启用它。[/]
[]将其移到加载顺序的末尾,使其在其他所有模组之后部署(之后添加模组时也要保持在此位置)。[/]
[]执行 [b]Purge[/b](清除)和 [b]Deploy[/b](部署)。[/]
[]按常规方式安装需要它的模组(例如 Treasure Radar 0.6.0 或更新版本)。[/]
[]Treasure Radar 0.5.1 或更早版本自带了一份加载器副本:请将其更新到 0.6.0。[/]
[/list]
[size=4][b]卸载[/b][/size]
在模组管理器中禁用它,然后执行 Purge 和 Deploy(需要它的模组将停止工作)。它在 %APPDATA%\Arrowhead\Helldivers2 中的文件(chef_loader.log、chef_loader_settings.txt、chef_loader_state.txt、chef_loader_trace.txt)可以删除。

[size=4][b]兼容性[/b][/size]
[list]
[]可运行所有 Chef 共享加载器模组。当 Chef 共享加载器部署在其之后时,自行替换游戏启动脚本的模组也会运行;其他模组加载器的启动脚本不会运行(否则会导致每个模组启动两次),日志和屏幕会对此作出说明。[/]
[]只有你能看到其菜单和监视器;其他人不需要它,除非他们自己使用了相关模组。[/]
[]在 2026 年 10 月游戏版本(Lua 5.1 构建)上制作并测试。[/]
[/list]
[size=4][b]故障排除[/b][/size]
[list]
[]某个模组不运行:请检查 Chef 共享加载器是否已启用、是否位于加载顺序的最后(在其他所有模组之后),以及是否执行了 Purge 和 Deploy。chef_loader.log 会说明它找到了哪些模组并启动了哪些模组。[/]
[]将日志附加到错误报告中:%APPDATA%\Arrowhead\Helldivers2 中的 [i]chef_loader.log[/i](在文件资源管理器地址栏中输入该路径并按 Enter)。它会显示它已启动、找到了哪些模组、任何 Lua 错误及其计时信息。[/]
[/list]
[size=4][b]致谢[/b][/size]
[list]
[]美术中使用的字体:Anton、Barlow Condensed 和 JetBrains Mono(SIL 开放字体许可证)。[/]
[/list]
[size=4][b]源代码[/b][/size]
源代码、模组制作者指南以及每个版本均可在 GitHub 上找到:[url=https://github.com/Th3chef/Chef-Shared-Loader]Th3chef/Chef-Shared-Loader[/url]