Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:15Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-mod-detection.svg|thumb|left|600px|Mod Detection]]

 

查看 ShroudForge 能识别哪些模组文件夹和文件。检测过程不会加载 DLL，也不会更改模组文件。


== 检测哪些内容？ ==

已安装的模组是解压后的文件夹，位于 <code>mods/<mod-folder>/</code> 下或你配置的模组目录中。ShroudForge 会读取 <code>mod.json</code>、可选的 <code>extended.mod.json</code>、<code>src/mod.lua</code>、<code>native-plugin.ini</code> 以及现有 DLL 文件。纯 Lua 模组不需要自带 DLL。原生模组即使没有清单或 Lua 文件，也可能显示在 DLL Manager 中。

此视图会说明文件夹及其中的信息是否已被识别。实际的原生加载情况会显示在 DLL Manager 中。模组自身的页面会显示其整体状态。


== 未知的清单字段 ==

启用 Mod Detection 模块和宽容读取后，<code>mod.json</code> 与 <code>extended.mod.json</code> 可以包含 ShroudForge 不认识的额外字段。仅有这些字段不会导致软件包被拒绝。已知字段仍必须包含有效值。无效 JSON、缺少必需信息和数据类型错误仍会报错。

关闭此兼容选项会恢复严格验证，但不会自动删除或禁用所有已安装的模组。


== 无法识别模组 ==

先检查实际的模组文件夹。下载文件夹中可能还套有一层包装文件夹或 <code>mods</code> 目录。安装程序会查找其中一个单独的模组软件包。包含多个模组软件包的新压缩包不会自动作为一组安装。请先解压，然后一次安装一个模组文件夹。正常运行时，ShroudForge 读取的是解压后的模组文件夹，而不是压缩包。

修正报告中指出的 JSON 位置，或重新安装完整软件包。兼容性配置文件可以为已知差异提供适配器。识别成功本身并不能确认原生钩子或模组 API 可以正常工作。

[[Category:guide:Shroudforge]]

Mod Detection/zh - Revision history

Bonsaibauer: Importing a new version from external source