世界分区构建器命令参考

世界分区通过UWorldPartitionBuilderCommandlet和UWorldPartitionBuilder基类引入了一个编译器Commandlet框架。

这些Commandlet用于完成自动化批处理，以及生成/修改世界分区关卡中的数据。 大型世界不必一次性全部加载，就能完成HLOD、AI导航数据的生成，或重新保存大量Actor等操作。

世界分区HLOD构建器

HLOD是使用世界分区HLOD编译器commandlet生成的。 运行该Commandlet会根据你在HLOD层中指定的生成设置，为你的世界分区单元创建HLOD Actor。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -AllowCommandletRendering -builder=WorldPartitionHLODsBuilder

如需详细了解在世界分区中使用HLOD和世界分区HLOD编译器Commandlet，请参阅世界分区 - 分层细节级别文档。

世界分区小地图构建器

世界分区小地图编译器（World Partition MiniMap Builder）commandlet可以生成或更新在世界分区编辑器窗口中显示的小地图。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -AllowCommandletRendering -builder=WorldPartitionMiniMapBuilder

世界分区重命名复制构建器

世界分区重命名复制编译器（World Partition Rename Duplicate Builder）commandlet可以自动重命名或复制现有的世界分区关卡及其所有Actor。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -SCCProvider=None -builder=WorldPartitionRenameDuplicateBuilder -NewPackage=/Game/ThirdPersonBP/Maps/NewPackage

该命令会为OpenWorldTest地图创建一个名为NewPackage的世界分区关卡副本，而不会改动原始地图。

如需重新命名你的世界分区地图，而非创建副本，请添加-Rename参数。

世界分区重新保存Actor构建器

世界分区重新保存Actor编译器（World Partition Resave Actors Builder）commandlet可以重新保存世界分区关卡中的所有Actor，同时支持类筛选器，以便只重新保存一部分Actor。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -SCCProvider=None -builder=WorldPartitionResaveActorsBuilder

在执行上面这段命令后，OpenWorldTest中所有的Actor都会被重新保存。

你可以使用-ActorClass参数，指定只保存一部分Actor。 例如，添加-ActorClass=StaticMeshActor即可只重新保存指定关卡中的静态网格体Actor。

世界分区植被构建器

在世界分区地图中，默认的实例化植被网格大小为256米。 世界分区植被编译器（World Partition Foliage Builder）commandlet可以改变现有世界分区关卡中的实例化植被网格大小。

命令： UnrealEditor.exe QAGame Playground.umap -run=WorldPartitionBuilderCommandlet -Builder=WorldPartitionFoliageBuilder -NewGridSize=Value

如需详细了解如何使用世界分区的植被模式，请参阅植被模式文档。

世界分区导航数据构建器

世界分区导航数据编译器（World Partition Navigation Data Builder）commandlet可以重新生成世界分区关卡的寻路网格体。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -AllowCommandletRendering -builder=WorldPartitionNavigationDataBuilder -SCCProvider=None

该Commandlet接受以下参数：

世界分区智能对象集合构建器

世界分区智能对象集合构建器命令（World Partition Smart Object Collection Builder）可以基于世界分区关卡中的所有智能对象组件，重建智能对象集合。

命令：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -builder=WorldPartitionSmartObjectCollectionBuilder

在执行上面的命令时，OpenWorldTest关卡中的所有智能对象集合都会被重新构建。 你可以在该commandlet中使用-SCCProvider参数来指定使用哪个版本控制提供商。

世界分区PCG构建器

世界分区PCG编译器（World Partition PCG Builder）commandlet可以完全加载关卡，等待异步进程完成（例如静态网格体构建），然后在匹配的PCG组件上安排生成。 所有生成完成后，进程会保存世界分区关卡并退出。

命令行：UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -Unattended -AllowCommandletRendering -run=WorldPartitionBuilderCommandlet -Builder=PCGWorldPartitionBuilder -IncludeGraphNames=PCG_GraphA;PCG_GraphB

控制台命令：pcg.BuildComponents -IncludeGraphNames=PCG_GraphA;PCG_GraphB

该Commandlet接受以下参数：