Dungeons Mod Kit
1.0.0
这是一组工具，可以让您更轻松地开发 Minecraft Dungeons 的模组。这些工具只能在 Windows 上运行。
如果您正在寻找为游戏制作资源包的工具，请查看模组套件的resource-packs分支。
需要安装这些才能使用这些工具：
您可以通过 Epic Games Store 应用免费下载虚幻引擎，只需确保选择版本 4.22.x 即可。使用不同版本的UE4会导致各种奇怪的问题。
这些工具中包含一些示例文件，如果您要制作自己的模组，您可能需要删除这些文件：
您可以使用Tools/clean_up_mod_kit.bat工具自动删除它们。
编辑Tools/user_settings文件夹中的文本文件以配置工具：
| 文件 | 描述 |
|---|---|
| 编辑器目录.txt | 它包含虚幻编辑器可执行文件所在文件夹的路径。 |
| 包输出.txt | 这包含 package.bat 工具创建的 .pak 文件的路径。 |
建议将 package_output 路径设置为~mods文件夹中的文件，以便轻松测试 mod。
默认情况下，材料配置为不打包。如果您想更改它，或者如果您想排除打包其他虚幻资源，您可以编辑Tools/configs/copy_cooked_assets.rcj 。要包含材料，只需删除M_*.u*和MI_*.u* 。要排除某些文件，只需在底部添加文件名，每个文件名各占一行。如果删除所有过滤器，则还需要删除/XF 。
本指南假设您已经熟悉游戏文件以及如何提取它们。
任何 3D 模型、声音文件、非块纹理的纹理以及一堆其他东西都是Unreal 资源。这些文件应使用虚幻编辑器进行管理。您可以使用编辑器打开UE4Project文件夹中的Dungeons.uproject文件来打开项目。
虚幻资产在打包之前需要进行烹饪。
运行cook_assets.bat工具来烘焙资源并自动将它们复制到Dungeons文件夹中，准备打包。
您可以通过编辑Tools/configs/copy_cooked_assets.rcj来排除某些文件，如上面的设置部分中所述。默认情况下，排除材质文件。
对于已经煮熟的虚幻资产，例如修改后的蓝图.uasset文件，您可以将它们放在Precooked文件夹中，它们将在运行cook_assets.bat工具时自动添加。如果您没有Precooked文件夹，只需在 mod 套件的根文件夹中创建一个，位于Dungeons 、 UE4Project 、 package.bat等旁边。
请注意，运行cook_assets.bat工具时，直接放入Dungeons文件夹中的任何已煮熟的资源都将被删除，因为它需要在将新资源复制到该文件夹之前清理旧资源。
任何不是虚幻资产的内容（例如关卡 .json 文件）都应添加到Dungeons文件夹中。该文件夹将被转换为 .pak 文件。
要测试您的 mod，您可以运行package.bat工具来创建 .pak 文件。如果该工具配置为将 .pak 文件放置在~mods文件夹中，则您可以在游戏完成后立即开始游戏。
要打包您的 mod 进行发布，请使用Tools/pack_compressed.bat工具。该工具将在您的Tools文件夹中创建一个compressed_pack.pak文件。创建此 .pak 文件通常需要稍长的时间，但文件大小应该小得多。您可以将 .pak 文件重命名为您想要的任何名称。
