World Partition Builder コマンドレットのリファレンス

World Partition では、UWorldPartitionBuilderCommandlet と UWorldPartitionBuilder 基本クラスによるビルダー コマンドレット フレームワークを導入しています。

これらのコマンドレットを使用して、バッチ プロセスを自動化したり、World Partition レベルでデータを生成または変更したりできます。 HLOD、AI Nav Data の生成、多数のアクタの再保存などを実行するため、大規模なワールドは一度にすべてをロードする必要はありません。

World Partition HLODs Builder

HLOD は World Partition HLODs Builder コマンドレットを使用して生成されます。 このコマンドレットを実行すると、HLOD レイヤーで指定した生成設定に従って、World Partition セルの HLOD アクタが作成されます。

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

World Partition での Hierarchical Levels of Detail (HLOD) および World Partition HLODs Builder コマンドレットの使用方法の詳細については、「World Partition - Hierarchical Level of Detail」を参照してください。

World Partition MiniMap Builder

World Partition MiniMap Builder コマンドレットは、WorldPartition エディタ ウィンドウに表示されるミニマップを生成または更新します。

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

World Partition名前変更複製ビルダー

World Partition Rename Duplicate Builder コマンドレットは、既存の World Partition レベルとそのすべてのアクタの名前を変更または複製するプロセスを自動化します。

コマンド：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 マップの World Partition レベルを NewPackage という名前で複製し、元のマップはそのまま残します。

コピーを作成するのではなく、World Partition マップの名前を変更するには、-Rename 引数を追加します。

World Partition再保存アクタビルダー

World Partition Resave Actors Builder コマンドレットは、World Partition レベルのすべてのアクタを再保存し、アクタのサブセットのみを再保存するクラス フィルタをサポートします。

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

この例を実行すると、OpenWorldTest レベルにあるすべてのアクタのパッケージが再保存されます。

-ActorClass 引数を使用すると、再保存するアクタのサブセットのみを指定できます。 たとえば、-ActorClass=StaticMeshActor を追加すると、指定したレベルのスタティックメッシュ アクタのみが再保存されます。

World Partitionフォリッジビルダー

World Partition マップでは、フォリッジ インスタンスのデフォルトのインスタンス化されたフォリッジ グリッド サイズは 256 m です。 World Partition Foliage Builder コマンドレットは、既存の World Partition レベルのインスタンス化フォリッジ グリッド サイズを変更するために使用されます。

コマンド：UnrealEditor.exe QAGame Playground.umap -run=WorldPartitionBuilderCommandlet -Builder=WorldPartitionFoliageBuilder -NewGridSize=Value

World Partition でのフォリッジ モードの使用方法の詳細については、「フォリッジ モード」を参照してください。

World Partitionナビゲーションデータビルダー

World Partition Navigation Data Builder コマンドレットは、World Partition レベルのナビメッシュを再ビルドします。

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

このコマンドレットでは、次の引数をとります。

World Partitionスマートオブジェクトコレクションビルダー

World Partition Smart Object Collection Builder コマンドレットは、World Partition レベルのすべてのスマート オブジェクト コンポーネントからスマート オブジェクト コレクションを再ビルドします。

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

この例を実行すると、OpenWorldTest レベルのすべてのスマート オブジェクト コレクションが再ビルドされます。 このコマンドレットで -SCCProvider 引数を指定すると、使用するソース管理プロバイダを指定することができます。

World Partition PCG ビルダー

World Partition PCG ビルダー コマンドレットはレベルを完全に読み込み、スタティックメッシュのビルドなどの非同期プロセスが完了するのを待機した後、一致する PCG コンポーネントの生成をスケジュールします。 すべての生成が完了すると、プロセスは World Partition レベルを保存して終了します。

コマンドライン：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

このコマンドレットでは、次の引数をとります。