跳至正文
版本：latest - a1.147.x ⚖️

资产开发工具包

如何使用 nanos world 资产开发工具包 - ADK

nanos world 提供了一个名为资产开发工具包（ADK）且完全可配置并准备就绪的虚幻项目，以帮助你更快速地集成和导出资产与地图。

该项目包含占位符、工具以及正确的引用，这些是创建角色或设置合适的物理材质等操作所必须使用的。

下载资产开发工具包​

我们的 ADK 已上传至 GitHub，请下载其最新版本并解压到你的计算机中。

打开项目​

你会在其中找到一个名为 NanosWorldADK.uproject 的文件，直接使用虚幻引擎打开它即可（在继续之前，请确保你已设置虚幻引擎）。

由于需要编译初始着色器，首次打开可能需要一些时间。

当它完成所有着色器的编译后，你就可以继续执行下一步来导入资产，或者查看下方了解所有可用工具。

特别注意​

切勿修改、删除、创建或复制 NanosWorld/ 文件夹内的任何文件，否则 ADK 将无法正常工作。 此外，请确保你不会无意中修改它们！ 如果系统要求保存其中任何已修改的文件，一定要取消！ 所有引用都必须按原样使用 NanosWorld/。

NanosWorld/ 文件夹中包含一些资产，你可以使用它们来引用你的资产，并使导出的资产在游戏内使用时能够保持正确的引用关系。

更新到新的 ADK 版本​

要将你的虚幻项目更新到更高的资产开发工具包版本，你只需从 GitHub 下载最新版本，并将其解压/粘贴到现有项目之上，覆盖所有文件即可。

注意

建议备份你位于 Config/ 文件夹下的设置，因为在你修改过它们的情况下，它们会被覆盖。 通常情况下，在更新后手动将你修改过的设置重新应用到新的项目设置中会更好。

ADK 项目中可用的工具​

以下是所有可用于加速和辅助创建资产的工具及蓝图列表：

占位符蓝图​

NanosWorld/Blueprints/Placeholders/​

占位符蓝图概览

你可以使用占位符蓝图来设置载具、武器、角色和道具的生成位置。 归根结底，这只是为了帮助你生成带有生成位置的 Lua 代码。 这些蓝图不会随地图一起被烘焙。 使用 Lua 代码生成器可以生成包含所有生成位置的 Lua 脚本。

Lua 代码生成器​

NanosWorld/Blueprints/Utility/WBP_LuaCodeGenerator**​

Lua 代码生成器控件

Lua 代码生成器是一个编辑器工具控件，它会扫描当前在虚幻引擎中加载的地图，并为你生成过的每一个占位符蓝图生成一份包含精确位置和旋转的生成代码列表。

要打开它，请右键点击它并选择运行编辑器工具控件：

Assets.toml 生成器​

NanosWorld/Blueprints/Utility/WBP_AssetsTomlGenerator​

这是一个编辑器工具控件，它可以扫描一个文件夹（由 TextBox 指定），并为该文件夹中所有的资产生成一份可在 nanos world 中使用的 Assets.toml 配置。

太阳与天空 Actor​

NanosWorld/Blueprints/World/BP_SunSky​

这是一个预先配置的太阳与天空蓝图，如果你决定生成默认太阳，该蓝图可以被使用并通过 World.SpawnDefaultSun() 轻松替换为 nanos world 的官方太阳。 这对于获取在游戏内生成默认太阳时光照效果的近似结果非常有用。

信息

注： 通过脚本使用 World.SpawnDefaultSun() 覆盖太阳会重新生成太阳 Actor，这意味着在太阳与天空 Actor 上进行的任何配置都不会保留。

例如：光照强度、颜色、后处理和其他配置都将丢失。

物理材质​

NanosWorld/MaterialLibrary/PhysicalMaterials/​

如果你正在创建材质，你可以（且应该）使用这些物理材质来更好地与 nanos world 融合。 使用这些物理材质将允许 nanos world 识别出你的道具/物体属于哪种表面类型，从而为其赋予合适的自动生成击中音效或脚步声。

注意

切勿修改或重命名任何物理材质，仅在你的材质中通过引用来使用它们。

Mannequin 骨骼​

NanosWorld/Characters/Common/SKEL_Mannequin​

为了能够创建可以与我们的 Character 类协同工作的骨骼（角色）网格体，你必须将你的骨骼网格体设为使用我们的 Mannequin 骨骼。 该骨骼与虚幻引擎 5 的默认 Mannequin 相同，因此任何使用 UE4 Mannequin 骨骼的骨骼网格体都可以对我们适用！

要更改骨骼网格体的骨骼：右键单击它 >> 骨骼 (Skeleton) >> 分配骨骼 (Assign Skeleton)，并将其更改为我们的 SKEL_Mannequin。

缩略图生成器​

NanosWorld/Blueprints/Utility/ThumbnailGenerator​

我们内置了一个缩略图生成器工具，以帮助你生成资产的 .jpg 图像。 要使用它，只需打开 ThumbnailGenerator 关卡并点击 Play。 随后你将能够定义一个用于搜索资产的文件夹（目前仅支持静态和骨骼网格体）以及一个用于保存图像（.jpg）的文件夹。 你可以选择在输出文件夹中保持目录层级，或者将所有图像保存到同一个文件夹中。 一旦你点击 Generate，它就会开始加载所有资产并为其拍摄照片。

信息

注： 这可能是一个缓慢的过程，具体取决于你的资产在此之前是否已经编译过。

同样建议将缩略图生成两次，以确保它们能以尽可能最高的质量被保存下来。