地狱潜者2 自动清单

重要：

强烈建议观看示例教程视频（见视频标签页），尤其是当你不理解下面的说明时。

AutoManifest：面向《地狱潜者 2》模组作者的一键清单生成工具。

旨在通过扫描模组文件夹及其内容的结构，自动生成或更新模组的 manifest.json 文件。

如何使用该工具创建大型/一体化模组：

• 创建模组文件夹。
• 在模组文件夹中创建分类文件夹（例如护甲、武器、战略配备等）。强烈建议根据你期望的显示顺序为它们编号（“01 护甲”、“02 武器”、“03 战略配备”等）。如果分类无关紧要，只需创建一个文件夹。
• 将你现有的模组文件解压到选项文件夹中。每个选项文件夹应包含实际的“.patch_#”文件。
• 将选项文件夹整理到各自的分类文件夹中。
• 将修改相同资源（例如某个网格、LUT 等）的选项文件夹合并到一个包含子选项文件夹的选项文件夹中。如果你有无论应用哪个子选项都应被应用的补丁文件，请将这些补丁文件放在该选项文件夹中，与子选项文件夹并列。
• 确保文件夹名称与各自的模组/选项/子选项名称一致。
• 如果你决定使用图片（必须是 .jpg 或 .png），请确保图片命名正确或位于各自的叶文件夹中：
  • 模组封面图片：图片名称必须与模组文件夹名称一致。
  • 选项图片：
    • 对于带子选项的选项：图片名称必须与选项文件夹名称一致。
    • 对于不带子选项的选项：图片名称必须与选项文件夹名称一致，或者位于所述选项文件夹中。
  • 子选项图片：图片名称必须与“[选项文件夹名称] [子选项文件夹名称]”一致，或者位于所述子选项文件夹中。
  • 遵循此方案后，图片可以存储在你希望的任何位置（例如 images 文件夹等）。
• 运行该工具，粘贴模组目录，让它自动生成清单。
• 如果你决定使用描述，请在清单中输入模组/选项/子选项描述。
• 压缩模组文件夹的内容为 zip/7z/等格式，以便上传。

如何使用该工具更新大型/一体化模组（仅适用于按上述结构组织的模组）：

• 将模组解压到模组文件夹中。
• 添加、编辑和删除所需的分类、选项和子选项。
• 如有需要，重命名图片以匹配其更新后的目录路径（见上方方案）。
• 运行该工具，粘贴模组目录（包含现有清单），让它自动更新 manifest.json 和 old_manifests.txt 历史文件。
• 确保没有任何描述因文件夹重命名或重新组织而“断开连接”。如果有，请从 old_manifests.txt 中的先前清单复制并粘贴它们。

该工具极大地减少了制作大型/一体化模组中最困难的部分之一：编写和维护清单。

只要模组作者正确地组织和命名内容，AutoManifest 工具就可以通过自动创建结构化、可更新的清单来节省他们的时间。

该工具的作用（可选阅读）：

• 询问模组文件夹的目录。
• 检查是否存在 manifest.json。
  • 如果存在，它会将备份保存到 old_manifests.txt 历史文件。
  • 它会保留重要字段：
    • 模组版本。
    • 模组 GUID。
    • 模组描述。
    • 选项和子选项描述，前提是它们的名称保持不变。
• 如果不存在清单，它会基于 3 层文件夹结构从头构建一个：
  • 1. 分类层：对护甲、武器、战略配备等类别进行分组。
  • 1. 选项层：正在被修改的单个资源，例如单个网格或 LUT。
  • 1. 子选项层：同一资源的替代版本，其中只能应用一个。
  • 在每一层，所有项目都会按字母顺序添加。
• 通过各自的文件夹名称定义模组、选项和子选项名称。
• 搜索整个模组目录中的图片（.jpg 和 .png）：
  • 模组封面图片：图片名称必须与模组文件夹名称一致。
  • 选项图片：
    • 对于带子选项的选项：图片名称必须与选项文件夹名称一致。
    • 对于不带子选项的选项：图片名称必须与选项文件夹名称一致，或者位于所述选项文件夹中。
  • 子选项图片：图片名称必须与“[选项文件夹名称] [子选项文件夹名称]”一致，或者位于所述子选项文件夹中。
• 最后执行：
  • 生成 manifest.json（如果是首次运行）。
  • 更新 manifest.json 并创建/更新 old_manifests.txt（如果是在现有模组上运行）。

如何使用 AutoManifest.py 文件自行制作（可选阅读）：

• 安装 VSCode。
• 安装 py2exe 扩展。
• 编写 AutoManifest.py。
• 导出为 .exe。

更多信息和资料请参见 https://github.com/TrooperC6P7/Helldivers_II。