
MDL(模组动态加载器) Pro
Activate, de-activate or add mods, when game still running! 动态模组加载器,实时启停模组。
查看大图描述
描述你的 mod 的主要用途
安装说明
列出用户安装你的 mod 必须遵循的步骤
主要功能
描述你的 mod 的核心功能
前置需求
提供有关额外所需步骤、资源或 mod 的信息
致谢
感谢任何启发或帮助过你的人。
MDL - Mod Dynamic Loader 1.8.7
在游戏运行中加载、停止、重载 Helldivers 2 的 mod。无需重启,无需 Deploy。
Load, stop and reload Helldivers 2 mods while the game is running. No restart, no Deploy.
英文
MDL 是什么?
MDL 是 Helldivers 2 的 mod 加载器,驻留在你的 ESC 菜单中。它在“游戏 / 社交 / 选项”旁新增一个 MDL 设置 标签页。在该标签页中,你可以启动和停止 Lua mod,直接从你的 HD2 Arsenal / HD2MM 库中运行脚本插件,无需重启即可开启和关闭资源 mod(模型、贴图),并查看每个 mod 每帧的开销。
重要:不要将 MDL 与 Bingus Shared Loader 一起安装
MDL 取代 Bingus Shared Loader(BSL)。它包含自己的启动加载器,以与 BSL 相同的方式查找和启动插件,并提供相同的插件 API(BSL API 1)。
- 如果已安装 BSL,请在 Arsenal / HD2MM 中禁用它,然后 Deploy MDL。
- 声明“Requires BSL”或“Requires BSL or MDL”的 mod 可与 MDL 配合使用,包括 Mod Options Menu 和 Mod Bindings Menu。
- 你只需要一个加载器。MDL 完成了 BSL 能做的所有事情,以及下文所述的所有功能。
亮点
- 游戏内热加载。 从 ESC 菜单启动、停止和重载 Lua mod,无需重启,也无需 Deploy。
- 你的库,实时可用。 Arsenal / HD2MM 库中的脚本插件一键运行,直接从管理器的文件中读取。
- 资源 mod 无需重启。 在游戏中开启和关闭模型与贴图。它们会在游戏下次加载这些资源时生效:下一局任务,或回到飞船上。
- 混合 mod 也可以。 同时包含脚本和资源的 mod 可以实时上线:其脚本立即启动,资源在下次加载时生效。
- 查看每个 mod 的开销。 每个 mod 的帧耗时、Lua 内存估算、分配速率,以及可选的每个 mod 创建的引擎对象和原生内存。
- 安全设计。 mod 在各自的环境中运行。持续出错的 mod 会被停止。mod 停止时会撤销内存补丁。插件不会被启动两次。
- 原生外观。 真正的 ESC 菜单标签页。两套主题,内置英文和简体中文,所有文本均可翻译。
功能详解
ESC 菜单标签页
- 在游戏内 ESC 菜单中新增 MDL 设置 作为原生标签页。
- 安装 Mod Options Menu 后,其 MODS 标签页仍为第 4 个,MDL 设置成为第 5 个。两者均正常工作。
- 如果无法添加标签页(未知的游戏版本,或
native_tab = false),面板将改为在菜单右侧打开。 - 标题栏中的 ? 按钮会打开帮助页面,解释每种类型、状态和 Arsenal 的 Deploy。
实时 Lua mod(Mods 文件夹)
- 将 mod 放入
%LOCALAPPDATA%\MDL\Helldivers2\Mods\<name>\mod.lua,可选附带icon.png。 - 点击 mod 的状态即可开启或关闭。其页面提供 从磁盘重新加载 以及 mod 自己的选项(开关、数值、选项、动作)。
- 自动重载(设置):当你保存 mod 的 Lua 文件时,MDL 会重载它。MDL 使用 Windows 变更通知,因此不进行轮询。
- 设置
update = .../shutdown = ...的传统脚本同样可用。MDL 会捕获这些回调。
Mod 库(HD2 Arsenal / HD2MM)
- 列出当前 Arsenal 配置方案中(或 HD2MM 中)的每个 mod,并带有图标。每个 mod 的名称下方显示文件名,因此可以区分同名 mod。
- mod 按类型分组:
- 脚本 - 实时:脚本插件(带有
-- HD2-Addon:行)。点击 OFF 即可立即从库中运行,无需 Deploy。 - 资源 - 下次加载时生效:模型、贴图和其他无需重启即可切换的资源。
- 混合:脚本加资源。尽可能实时生效;否则页面会说明原因。
- 仅启动时:只能随游戏启动的 mod。分组旁的 ? 解释了原因,以及如何在 Arsenal 中启用它们。
- 脚本 - 实时:脚本插件(带有
- Arsenal / HD2MM 在启动时已加载的插件显示 已由 Arsenal 启动,并且永远不会被第二次启动。
- 当你将正在运行的插件的新版本导入 Arsenal 时,MDL 会重载它(需开启自动重载)或将其标记为过时。
- 库页面显示 mod 文件的类型、内容、最后更新时间和大小。
实时资源 mod
- 点击资源 mod 旁的 OFF。首次操作时,MDL 会花几秒钟查找该 mod 替换的资源位于哪些游戏包中,并记住结果。
- 然后 MDL 将 mod 的副本放置在这些包旁边。游戏下次加载它们时会采用该 mod。
- 实时开启 在等待下次加载时为黄色,mod 激活后为绿色。再次点击即可关闭。仍在使用中的副本会在游戏卸载它们后删除。
- 仅修改启动时一次性加载的资源的 mod 显示 仅启动时。请对这类 mod 使用 Arsenal。
- 每个 mod 请只使用实时方式或通过 Arsenal 启用,不要同时使用两种方式。当 Arsenal 部署某个 mod 时,MDL 会移除自己的副本。
性能与诊断
- 每个运行中的 mod 的 帧开销(平均值和峰值),以及所有实时 mod 的总计。
- 每个 mod 的 更新频率,从每帧到每 8 帧,适用于仅做轮询的 mod。跳过的时间会累加到
dt中。 - MDL 自身的开销 显示在主页右下角,并附有各部分明细。
- Lua 内存(估算):运行中的 mod 持有的内容(表、字符串、函数)。以每帧最多 1 ms 的分片进行测量。
- 分配速率(KB/s):mod 的 update 产生多少垃圾。
- 引擎对象和原生内存(可选设置)。统计 mod 创建的单位、GUI 和特效,以及它通过
ffi.C(VirtualAlloc / HeapAlloc / malloc)占用的内存。已停止的 mod 页面会显示它 遗留下来的内容。 - 后台日志写入:插件频繁重写的日志文件以异步方式写入,因此游戏线程不会被阻塞。
- LuaJIT 代码缓存在启动时扩大,与 BSL 相同,以便同时编译多个 mod。
安全
- 每个实时 mod 拥有自己的环境。其全局变量保持独立,而共享全局变量在 mod 之间仍然有效。
- 回调失败 5 次的 mod 会被自动停止,原因显示在其页面上。
- 通过
ctx.write写入的内存会在 mod 停止时恢复,但仅在自那以后没有其他人更改过的情况下。 - 在自身 update 内调用游戏 update 的 mod 会被捕获。多余的调用被忽略,该 mod 被标记。
- 游戏更新后,MDL 在启动时会重新查找所需的一切。任何找不到的内容会自动关闭;MDL 不会猜测。
界面
- 每个区域的 排序:加载顺序、A-Z 或最新更新优先。
- 每个区域的 折叠。启动插件区域默认折叠。
- 主题:Helldivers(深色底黄色)和 Archive(纸张与墨色)。
- 语言:默认自动。依次跟随游戏语言、Steam 语言、Windows 语言。中文显示中文;MDL 没有对应语言文件的任何其他语言显示英文。
- 翻译:所有文本位于
Languages\<code>.json。编辑任意一行,或复制en.json以添加语言。 - 可选的动画,以及可选的键盘控制(
keyboard_in_menu)。
安装
- 关闭游戏。
- 如果安装了 Bingus Shared Loader:在 Arsenal / HD2MM 中禁用它。
- 将 MDL zip 导入 HD2 Arsenal(或 HD2MM),启用它并点击 Deploy。
- 启动游戏,按 ESC 并打开 MDL 设置 标签页。
卸载: 在 Arsenal / HD2MM 中禁用 MDL 并 Deploy。之后你可以删除 %LOCALAPPDATA%\MDL。
文件
| 内容 | 位置 |
|---|---|
| 实时 Lua mod | %LOCALAPPDATA%\MDL\Helldivers2\Mods\ |
| 设置 | %LOCALAPPDATA%\MDL\Helldivers2\MDL.cfg |
| 语言文件 | %LOCALAPPDATA%\MDL\Helldivers2\Languages\ |
| 日志(反馈问题时请附上) | %LOCALAPPDATA%\MDL\Helldivers2\Logs\MDL.log |
给 mod 作者
带有 -- HD2-Addon: mods/<author>/<name> 首行的脚本插件无需修改即可从库中实时运行。对于为 MDL 制作的 mod,mod.lua 接收 ctx 并返回一个表:
local ctx = ...
return {
name = 'My Mod', version = '1.0', author = 'me', icon = 'icon.png',
options = {
{key = 'on', label = 'Feature', type = 'toggle', default = true},
{key = 'power', label = 'Power', type = 'number', default = 1, min = 0, max = 5, step = 0.5},
},
on_enable = function(ctx) end,
on_update = function(ctx, dt) end,
on_setting = function(ctx, key, value) end,
on_disable = function(ctx) end,
}
ctx 提供:
settings/set:为你保存的选项。log。on_cleanup。cdef:可安全地重复调用。module、read。write(address, bytes[, expected]):mod 停止时撤销。restore。global:mod 停止时清除。- 后台任务:
spawn、yield、sleep、wait_frames、checkpoint。 scan:分摊到多帧的特征码扫描。
注意与限制
- Lua mod 拥有与游戏相同的权限。请只安装你信任的 mod。
- 资源更改在下次加载这些资源时生效(下一局任务或回到飞船上),而非立即生效。
- 有些 mod 只能从游戏启动时开始工作;MDL 会告诉你是哪些以及原因。
- 内存数值是对 Lua 对象的估算。模型或贴图等引擎内存不包含在内。
- MDL 不会检测两个不同 mod 修改同一内容时的冲突。
致谢
- Lua 插件发现和启动注册基于 CowboyBingus 的 Bingus Shared Loader v18。感谢其打下的基础。
- LuaJIT(MIT 许可证)。
也试试: Echelon Mod Manager:https://www.nexusmods.com/helldivers2/mods/16613
中文
MDL 是什么?
MDL 是 Helldivers 2 的 mod 加载器,装好后会出现在 ESC 菜单里:在“游戏 / 社交 / 设置”旁边多出一个 MDL 设置 页签。在这里你可以:
- 随时启动、停止 Lua mod;
- 直接运行 HD2 Arsenal / HD2MM 库里的脚本插件;
- 不重启就开关资源 mod(模型、贴图);
- 查看每个 mod 每帧的开销。
重要:不要与 Bingus Shared Loader 同时安装
MDL 取代 Bingus Shared Loader(BSL)。MDL 自带启动加载器,发现和启动插件的方式与 BSL 相同,并提供同样的插件接口(BSL API 1)。
- 如果装了 BSL,请先在 Arsenal / HD2MM 中禁用它,再 Deploy MDL。
- 写着“Requires BSL”或“Requires BSL or MDL”的 mod 在 MDL 下照常工作,包括 Mod Options Menu 和 Mod Bindings Menu。
- 只需要一个加载器:BSL 能做的 MDL 都能做,另外还有下面这些功能。
亮点
- 游戏内热加载:在 ESC 菜单里启动、停止、重载 Lua mod,不用重启,也不用 Deploy。
- 库里的 mod 直接运行:Arsenal / HD2MM 库中的脚本插件点一下就能运行,直接读取管理器里的文件。
- 资源 mod 免重启:游戏中开关模型和贴图,游戏下次加载这些资源时生效(下一局任务或回到飞船)。
- 混合 mod 也行:同时带脚本和资源的 mod 可以实时开启,脚本立即运行,资源在下次加载时生效。
- 每个 mod 的开销一目了然:每帧耗时、Lua 内存估算、分配速度;还可以选择统计它创建的引擎对象和原生内存。
- 安全设计:每个 mod 在自己的环境里运行;反复出错的 mod 会被自动停止;停止时还原它改过的内存;同一个插件不会启动两次。
- 原生外观:真正的 ESC 菜单页签,两套主题,内置英文和简体中文,所有文字都可以翻译。
功能细则
ESC 菜单页签
- 在游戏内 ESC 菜单中加入原生页签 MDL 设置。
- 装有 Mod Options Menu 时,它的 MODS 页仍是第 4 页,MDL 设置是第 5 页,两者都能正常使用。
- 页签加不上时(未知的游戏版本,或设置了
native_tab = false),面板改为显示在菜单右侧。 - 标题栏的 ? 按钮打开帮助页,解释所有类型、状态和 Arsenal 的 Deploy。
实时 Lua mod(Mods 文件夹)
- 把 mod 放在
%LOCALAPPDATA%\MDL\Helldivers2\Mods\<名称>\mod.lua,可以附带icon.png。 - 点 mod 的状态即可开关。mod 详情页可以“从磁盘重新加载”,也可以调整 mod 自己的选项(开关、数值、选项、动作)。
- 自动重载(设置):保存 mod 的 Lua 文件后,MDL 会自动重载它。MDL 用的是 Windows 的目录变更通知,不需要轮询。
- 用
update = .../shutdown = ...写的传统脚本同样支持,MDL 会接管这些回调。
Mod 库(HD2 Arsenal / HD2MM)
- 列出 Arsenal 当前配置方案(或 HD2MM)中的全部 mod,带图标。名称下方显示文件名,同名 mod 也能分清。
- 按类型分组:
- 脚本 - 实时:带
-- HD2-Addon:声明的脚本插件。点“关”就能立即从库里运行,不用 Deploy。 - 资源 - 下次加载时生效:模型、贴图等资源,不重启即可开关。
- 混合:脚本加资源。条件允许时可以实时开启,不能时页面会说明原因。
- 仅启动时:只能随游戏启动的 mod。分组旁的 ? 说明原因,以及如何在 Arsenal 中启用。
- 脚本 - 实时:带
- 已被 Arsenal / HD2MM 在启动时加载的插件显示“已由 Arsenal 启动”,不会再启动第二份。
- 把正在运行的插件的新版本拖进 Arsenal 后,MDL 会自动重载它(需开启自动重载),否则标记为“有新版本”。
- 库详情页显示类型、内容、最近更新时间和文件大小。
资源 mod 实时开关
- 在资源 mod 旁点“关”。第一次会花几秒查找它替换的资源在哪些游戏资源包里,结果会记住。
- 之后 MDL 把 mod 的副本放到这些资源包旁边,游戏下次加载它们时就会用上。
- 实时开启 为黄色时表示等待下次加载,变绿表示已生效。再点一次即可关闭,仍在使用中的副本会在游戏卸载这些资源后删除。
- 只修改游戏启动时一次性加载的资源的 mod 显示“仅启动时”,请用 Arsenal 启用。
- 同一个 mod 请只用一种方式:要么实时,要么 Arsenal。Arsenal 部署某个 mod 时,MDL 会删掉自己放的副本。
性能与诊断
- 每帧耗时:每个运行中的 mod 的平均值和峰值,以及所有实时 mod 的合计。
- 更新频率:可以按 mod 设置,从每帧到每 8 帧一次,适合只做轮询的 mod;跳过的时间会累加进
dt。 - MDL 自身耗时:主页右下角显示,点开可以看各部分。
- Lua 内存(估算):运行中的 mod 持有的表、字符串、函数等。测量分片进行,每帧最多 1 ms。
- 分配速度(KB/s):mod 的 update 每秒产生多少垃圾。
- 引擎对象和原生内存(可选设置):统计 mod 创建的单位、GUI、特效,以及它通过
ffi.C(VirtualAlloc / HeapAlloc / malloc)申请的内存。mod 停止后,详情页列出它的遗留。 - 日志后台写入:插件频繁重写的日志文件改为异步写入,不阻塞游戏线程。
- 启动时扩大 LuaJIT 代码缓存(与 BSL 相同),让大量 mod 都能被编译。
安全
- 每个实时 mod 有自己的环境:它的全局变量互不干扰,mod 之间共享的全局照常可用。
- 回调累计出错 5 次的 mod 会被自动停止,原因显示在它的页面上。
- 通过
ctx.write写入的内存,在 mod 停止时会还原;如果期间被别人改过,就不还原。 - mod 在自己的 update 里调用游戏 update 时会被拦下:多出来的那次调用被忽略,并给该 mod 标记警告。
- 游戏更新后,MDL 每次启动都会重新查找所需的一切。找不到的部分直接关闭,不会去猜。
界面
- 排序(每个分类单独设置):加载顺序、A-Z、最近更新。
- 折叠(每个分类单独设置):“脚本插件(随游戏启动)”默认折叠。
- 主题:地狱潜兵(深色底黄字)和档案(纸张与墨色)。
- 语言:默认自动,依次跟随游戏语言、Steam 语言、Windows 语言。中文显示中文,MDL 没有对应语言文件时显示英文。
- 翻译:所有文字都在
Languages\<代码>.json里,可以改任意一行,也可以复制en.json添加新语言。 - 可选动画;可选键盘操作(
keyboard_in_menu)。
安装
- 关闭游戏。
- 如果装了 Bingus Shared Loader,先在 Arsenal / HD2MM 中禁用它。
- 把 MDL 压缩包导入 HD2 Arsenal(或 HD2MM),启用,点 Deploy。
- 启动游戏,按 ESC,打开 MDL 设置 页签。
卸载: 在 Arsenal / HD2MM 中禁用 MDL 并 Deploy,之后可以删除 %LOCALAPPDATA%\MDL。
文件位置
| 内容 | 位置 |
|---|---|
| 实时 Lua mod | %LOCALAPPDATA%\MDL\Helldivers2\Mods\ |
| 设置 | %LOCALAPPDATA%\MDL\Helldivers2\MDL.cfg |
| 语言文件 | %LOCALAPPDATA%\MDL\Helldivers2\Languages\ |
| 日志(反馈问题时请附上) | %LOCALAPPDATA%\MDL\Helldivers2\Logs\MDL.log |
给 mod 作者
第一行带 -- HD2-Addon: mods/<作者>/<名称> 的脚本插件无需修改,就能从库里实时运行。专为 MDL 写的 mod,mod.lua 接收 ctx 并返回一个表(示例见上方英文部分)。
ctx 提供:
settings/set:自动保存的选项。log。on_cleanup。cdef:可以重复调用。module、read。write(地址, 字节[, 期望值]):mod 停止时自动还原。restore。global:mod 停止时清除。- 后台任务:
spawn、yield、sleep、wait_frames、checkpoint。 scan:分摊到多帧的特征码扫描。
注意与限制
- Lua mod 拥有和游戏相同的权限,请只安装你信任的 mod。
- 资源改动在游戏下次加载这些资源时才生效(下一局任务或回到飞船),不是立刻生效。
- 有些 mod 只能随游戏启动;MDL 会告诉你是哪些,以及原因。
- 内存数值是对 Lua 对象的估算,不包括模型、贴图等引擎内存。
- MDL 不检测两个不同 mod 修改同一处时的冲突。
致谢
- Lua 插件发现和启动注册基于 CowboyBingus 的 Bingus Shared Loader v18,感谢他打下的基础。
- LuaJIT(MIT 许可)。
也试试: Echelon 模组管理器:https://www.nexusmods.com/helldivers2/mods/16613
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。