2024-04-26 15:08:45 +08:00
---
title: World Partition(世界分区)
date: 2024-04-26 14:18:36
excerpt:
tags:
rating: ⭐
---
# 前言
文档地址： https://dev.epicgames.com/documentation/en-us/unreal-engine/world-partition-in-unreal-engine?application_version=5.3
- 知乎文章：
2024-04-27 12:19:36 +08:00
- UE5
- UE5 World Partition不完全指南:https://zhuanlan.zhihu.com/p/687020988
- UE4
- UE4旧版方案：
- UE4场景流送机制： （ ） ：
- UE4场景流送机制： （ ） & WorldComposition https://zhuanlan.zhihu.com/p/270172506
2024-04-26 15:08:45 +08:00
2024-04-27 12:19:36 +08:00
PS.可以使用Tools-Convert Level，
## 调试命令
| | |
|---|---|
|**wp.Runtime.ToggleDrawRuntimeHash2D**|开关世界分区运行时哈希的2D调试显示。|
|**wp.Runtime.ToggleDrawRuntimeHash3D**|开关世界分区运行时哈希的3D调试显示。|
|**wp.Runtime.ShowRuntimeSpatialHashGridLevel**|选择在显示世界分区运行时哈希时显示的网格级别。|
|**wp.Runtime.ShowRuntimeSpatialHashGridLevelCount**|选择在显示世界分区运行时哈希时要显示多少个网格级别。|
|**wp.Runtime.ShowRuntimeSpatialHashGridIndex**|显示世界分区运行时哈希时，显示指定的网格。无效的索引将导致显示所有网格。|
|**wp.Runtime.RuntimeSpatialHashCellToSourceAngleContributionToCellImportance**|取0到1之间的值， ，
|**wp.Runtime.OverrideRuntimeSpatialHashLoadingRange**|设置运行时加载范围。接受以下参数：< br >< br > - `-grid=[index]` ：设置你想影响的运行时网格。< br > - `-range=[override_loading_range]` : 设置新的运行时加载范围|
|**wp.Runtime.MaxLoadingLevelStreamingCells**|限制并发加载的世界分区流单元的数量。|
|**wp.Runtime.HLOD 0**|使用 `wp.Runtime.HLOD`
# 关卡实例化
这2个选项在Actor右键菜单中（ ）
- **Level Instance**
- 可以将任意Actor塞进去
- 采用**OFPA**系统保存关卡信息
- **Packed Level Actor**
- 继承自Level Instance
- 将所选的Actor变为component，
- 内部Actor不再使用**OFPA**的方式，
2024-06-13 19:01:58 +08:00
- 在Pack时只会打包场景资产类型，
# 官方文档阅读笔记
2024-06-14 16:49:03 +08:00
## 概念
- **流送源**： #PlayerController ]]是一种流送源，其他流送源可以使用 **世界分区流送源组件（ ） ，
- [[#DataLayer ]]： ， ，
2024-06-13 19:01:58 +08:00
## 将现有关卡转换为使用世界分区
可以使用**工具（ ） （ ）
2024-06-14 13:32:48 +08:00
`UnrealEditor.exe 项目名称 -run=WorldPartitionConvertCommandlet Playground.umap -AllowCommandletRendering`
## 相关设置
### WorldSettings
2024-06-14 16:49:03 +08:00
- **启用流送（ ）
- 使用MovieRenderQueue进行渲染时， ，
- ***Use External Actors***：
| | |
| ------------------------------------- | ----------------------------------------------------------------- |
| **网格名称（ ） | 包含运行时网格的名称。 |
| **单元大小（ ） | 确定用于生成流送关卡的网格单元的大小。在示例中， **单元大小（ ）
| **加载范围（ ） | 确定与流送源距离多远的范围之内会加载单元。在上图中， **加载范围（ ）
| **在缓慢流送时阻止（ ） | 在网格单元加载速度不够快的情况下阻止加载。 |
| **优先级（ ） | 确定流送源的优先级。如果某个网格单元与多个流送源相交，其优先级将是所有流送源中最高的。 |
| **调试颜色（ ） | 确定启用 **预览网格（ ） 时显示的网格线颜色。 |
| **预览网格（ ） | 启用时，将在视口中显示网格线。 |
2024-06-14 13:32:48 +08:00
### Actor
2024-06-14 16:49:03 +08:00
- Runtime Grid： ，
- Is Spatially Loaded：
- 如果启用，
- 如果禁用，
- Packaging Mode：
### PlayerController
- Enable Streaming Source：
### UWorldPartitionStreamingSourceComponent
| | |
| ------------------------------------------------ | -------------------------------------------------------------------- |
| **默认可视化器加载范围（ ） | 确定启用可视化器时调试可视化器网格的大小。 |
| **目标网格（ ） | 确定此源影响的流送网格。 |
| **调试颜色（ ） | 确定用于调试的颜色。 |
| **目标HLOD层（ ） | 确定流送源影响的HLOD层。 |
| **形状（ ） | 确定用于为此流送源构建自定义形状的形状列表。如果为空，将使用半径等于网格加载范围的球体。 |
| **优先级（ ） | 确定流送源的优先级。如果某个网格单元与多个流送源相交，其优先级将是所有流送源中最高的。 |
| **流送源已启用（ ） | 确定此组件是否已启用。 |
| **目标状态（ ） | 确定相交的网格单元应该处于的状态（已加载或已激活）。如果某个网格单元与多个流送源相交，目标状态将是最高的目标值（其中已激活高于已加载）。 |
蓝图函数 **Enable Streaming Source** 和 **Disable Streaming Source** 将启用和禁用此组件的流送。
### ALocationVolume
一种用于**加载/卸载** 指定区域的Volumn。可以在WorldPartition编辑器上点击来进行控制。也有三个蓝图函数用于控制加载与卸载：
- void Load()
- void Unload()
- bool IsLoaded() const
## 构建WorldPartition编辑器小地图
Build - Build Minimap
## DataLayer
官方文档:https://dev.epicgames.com/documentation/zh-cn/unreal-engine/world-partition---data-layers-in-unreal-engine?application_version=5.2
![[WorldPartition_LayerData.png|400]]
| | |
| ----- | ----------------------------------------------------------------------------------------- |
| **1** | 在关卡编辑器中切换关卡的可视性。仅当某个Actor所有关联数据层都隐藏时，
| **2** | 表示"动态加载（ ）
| **3** | 切换"编辑器动态加载（ ） ， ，
| **4** | 切换此数据层中所有Actor的可见情况 |
| **5** | 决定启动时数据层是否在编辑器中显示。 |
| **6** | 决定是否应该为此数据层中的Actor生成HLOD。仅当启用"动态加载（ ）
| **7** | 决定启用了"动态加载（ ）
| **8** | 决定数据层是否影响Actor的运行时加载。 |
### 使用蓝图或者c++控制DataLayer加载
通过**UDataLayerSubsystem**的SetDataLayerState()来控制DataLayer的加载与卸载。
## Level Instance
关卡实例化是一种基于关卡的工作流程， ：
- 关卡实例在相关环境中编辑，可以立即看到所做更改对你的世界的影响。对一个实例所做的更改在保存后将复用于所有实例。
- 快速创建静态网格体排列（ ）
- 在创建Epic Games所创建的[城市示例 ](https://www.unrealengine.com/marketplace/zh-CN/product/city-sample )和[Valley of the Ancient ](https://www.unrealengine.com/marketplace/zh-CN/product/ancient-game-01 )演示时所使用的生产级流程。
# 相关CommandLet
- 烘焙WorldPartition：
- HLOD Build： `UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -AllowCommandletRendering -builder=WorldPartitionHLODsBuilder`
- WorldPartition重命名复制： `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`
- WorldPartition重新保存Actor： `UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -SCCProvider=None -builder=WorldPartitionResaveActorsBuilder`
- WorldPartition植被构建： `UnrealEditor.exe QAGame Playground.umap -run=WorldPartitionBuilderCommandlet -Builder=WorldPartitionFoliageBuilder -NewGridSize=Value`
- WorldPartition Nav构建： `UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -AllowCommandletRendering -builder=WorldPartitionNavigationDataBuilder -SCCProvider=None`
- WorldPartition智能对象构建： `UnrealEditor.exe "C:\Users\user.name\Documents\Unreal Projects\MyProject\MyProject.uproject" "/Game/ThirdPersonBP/Maps/OpenWorldTest" -run=WorldPartitionBuilderCommandlet -builder=WorldPartitionSmartObjectCollectionBuilder`
- 转换子关卡为WorldPartition： `UnrealEditor.exe -run=ConvertLevelsToExternalActorsCommandlet -nosourcecontrol -convertsublevels "Game/Maps/TestMaps/ExternalActors/MainMap`
