做森林、野外这类开放场景时，纯手工摆放树木往往是整个场景制作中最费时间的环节。一棵树调好位置和大小，后面还有几十棵等着，而且要做到分布自然、不重复、不穿模，非常考验耐心。UE5 的 PCG（程序化内容生成，Procedural Content Generation）正好把这件事从“体力活”变成了“参数化流程”。本文将以一个森林小屋场景为例，完整拆解从地形准备、样条线规划、PCG 图搭建到细节植被生成的整个制作流程，适合刚接触 UE5 的入门玩家，也适合想把手动摆景流程升级为程序化流程的开发者参考。
看完这篇教程，你会掌握 PCG 的核心节点链路、如何使用样条线参与 PCG 生成、如何通过距离和密度规则让植被分布更接近真实自然环境，以及最容易踩坑的地方和对应的排查思路。整篇内容是图文版，不需要额外依赖视频，按文章顺序操作即可。
1. 程序化森林小屋的思路与 PCG 核心概念
1.1 PCG 到底解决了什么问题
UE5 场景制作中，植被摆放通常有三种做法：手动摆放、使用 Paint 工具刷植被、使用程序化生成。手动摆放适合中心区域的小范围精修，比如小屋门前的几棵定制树；刷植被适合草地和低矮植物；而大面积森林、山体植被、随机分布的碎石和树木，最适合用程序化生成。
PCG 解决的问题有几个：
- 数量问题：手动摆放上百棵树效率低，PCG 可以在几秒内生成数千个实例。
- 自然度问题：PCG 支持密度随机、缩放随机、朝向随机，结果比均匀排列更接近自然分布。
- 可调性问题：想调整密度或分布规律，只需要改参数，不用重新摆一遍。
- 复用问题：一张 PCG 图可以套用到多个场景，换地形、换样条线就能重新生成。
森林小屋场景非常适合作为 PCG 入门案例。它的区域范围不大，规则明确：小屋周围要有空地，空地外围是树木，再往外是岩石、灌木和蘑菇等细节。这些规则用 PCG 的采样、过滤和生成节点来实现非常合适。
1.2 PCG 在 UE5 中的组成
PCG 在 UE5 中不是单独的建模工具，而是一套基于节点图的生成框架。简单理解，它包含这几部分：
| 组成 | 作用 |
|---|---|
| PCG 图（PCG Graph） | 以节点方式定义生成逻辑，相当于一段可视化脚本 |
| PCG 组件（PCG Component） | 挂载在 Actor 上，负责在编辑器或运行时执行 PCG 图 |
| PCG 数据（PCG Data） | 生成过程中传递的点集、密度、属性和标签信息 |
| 静态网格生成器 | 把最终点集数据转化为场景中的 Static Mesh 实例 |
PCG 图内部处理的单位是“点”。一个点可以理解成带有位置、朝向、缩放和密度的信息对象。PCG 的核心工作就是不断加工这些点：从哪里取点、怎么过滤、怎么变换、最后生成什么资产。
需要区分的是，PCG 和 UE5 旧版的 Procedural Foliage Spawner 并不完全相同。后者主要针对植被刷子，使用方式和可控性都有限；PCG 是通用框架，支持样条线、Actor 数据、自定义节点和 C++ 扩展，应用范围更广。
2. 环境准备与素材规划
2.1 版本与插件准备
PCG 插件在 UE5.2 之后已经进入正式可用状态，后续版本不断完善。本文演示思路在 UE5.3、UE5.4、UE5.5 中通用，如果你使用的是 UE5.0 或 UE5.1，部分节点名称和默认行为可能略有差异，建议先以 UE5.3 以上版本练习。
版本需要根据你的项目实际情况调整，本文示例以常见环境为例，重点演示配置思路。
新建工程时，建议选择“Blank”模板或者“Third Person”模板。Blank 模板比较干净，方便后续自定义；Third Person 模板带有基本角色，方便在场景里实际走一圈检查植被密度是否合适。
创建工程后，先检查 PCG 插件是否启用：
- 打开菜单 Edit -> Plugins。
- 分类选择 Procedural。
- 确认 PCG 插件处于 Enabled 状态。
- 如果修改了插件状态，重启编辑器。
项目设置方面，普通练习场景保持默认即可。如果是正式项目，建议在 Project Settings 中提前规划好 Mesh 的 LOD 和 Nanite 设置。
2.2 素材准备
做森林小屋之前，需要准备一批基础资产。优先级从高到低如下：
- 树木：树干、树冠，或者直接使用带 LOD 的整树资产。
- 岩石：不同大小的几块，用于填补树下和空地边缘。
- 灌木：低矮植物，用于过渡层。
- 草：小片草簇，用于地面细节。
- 蘑菇或小花：点缀资产，数量少但能提升场景丰富度。
- 小屋主体：可以用 Quixel Megascans 资产，也可以用手边任意小屋模型，小屋本身手动摆放，PCG 负责周围环境。
素材来源上，建议优先使用 Quixel Bridge 下载的 Megascans 资产，UE5 自带 Bridge 插件，下载后可以直接导入工程。个人练习也可以使用 CC0 资源，注意确认授权即可。
2.3 创建工程与地形
打开 UE5 项目后，先创建一块地形。使用 Landscape 工具，在 Place Actors 面板搜索 Landscape，拖入场景并创建地形。练习场景不需要太大，512 到 1024 尺寸即可，分辨率不要太高，否则刷地形和性能调试都会变慢。
刷地形的思路：
- 中心区域保持平坦，用于放置小屋。
- 外围做少量起伏，方便树木分布更自然。
- 避免大面积陡坡，否则植被会悬浮或穿模，增加调整成本。
刷完后，手工放置小屋模型，并确定小屋门口方向和视野方向。小屋是场景中心，后续 PCG 的所有距离规则都以小屋位置作为参照。
3. 核心原理解析：采样、过滤与生成
3.1 PCG 图的基本流程
打开 Content Browser，在内容目录下右键 -> PCG -> PCG Graph 创建一张 PCG 图，命名为 PCG_Demo。双击打开后，是一个类似材质的节点编辑界面。
PCG 图的核心链路简单说就是：
输入区域（样条线 / Actor / Volume） ↓ Surface Sampler 表面采样生成点 ↓ Density Filter 密度过滤 ↓ Transform Points 变换位置/旋转/缩放 ↓ Static Mesh Spawner 生成静态网格这一条链路可以理解成“圈定范围 -> 撒点 -> 筛选 -> 变换 -> 生成”。下面逐个节点说明。
3.2 Surface Sampler 表面采样
Surface Sampler 是生成植被点最常用的节点。它会在指定区域的表面生成大量点，也就是一个带有密度值的点集合。
常用参数解释：
| 参数 | 含义 |
|---|---|
| Point Density | 每平方米或单位面积的点数 |
| Point Extents | 点的范围，影响采样时避免重叠的程度 |
| Bounds Scale | 采样边界缩放 |
| Seed | 随机种子，锁定后生成结果可复现 |
如果把 Point Density 调高，树木会很密；调低，场景会显得稀疏。实际项目中不是直接一个数值走天下，而是通过后续过滤器继续加工。
3.3 Density Filter 与 Transform Points
Density Filter 的作用是过滤点。PCG 中每个点都有密度值，过滤器可以按照密度范围、距离条件、标签条件来决定保留还是删除点。例如“距离小屋 5 米以内的点全部删除”“密度小于 0.3 的点全部删除”。
Transform Points 负责改变点的位置、旋转和缩放。在森林场景中，尤其常用：
- Rotation：随机旋转 Yaw，让树冠朝向不同。
- Scale：随机缩放 0.8 到 1.2，避免树木大小完全一致。
- Position：少量随机偏移，增加自然感。
理解这一点很重要：PCG 不只是在指定区域里随机放 Mesh，而是先处理点数据，最后统一生成。点和实例是两件不同的事情，调试时先看点，确认点分布正确后，再看最终生成效果。
4. 森林小屋完整实战案例
下面进入完整实操。这一部分会按照一个可落地的顺序展开，建议跟随每一步操作。
4.1 规划场景范围：样条线划定区域
森林小屋里，PCG 需要明确“哪些地方可以长树”。如果使用矩形 PCG Volume，区域太规整，植被分布会很假。更自然的方式是使用样条线。
在场景中放置一个 Spline Actor：
- Place Actors 面板搜索 Spline，拖入场景。
- 调整样条线控制点，圈出森林外围轮廓。
- 把样条线做成一个闭合多边形，形成大致林区范围。
然后创建 PCG Actor：
- Place Actors 面板搜索 PCG。
- 拖入场景。
- 在 PCG Actor 的 Details 面板中，把 PCG Graph 设为之前创建的 PCG_Demo。
- 在场景中选中样条线，然后在 PCG Actor 的 Generation 相关设置里，添加样条线作为输入数据源。
PCG 图中对应的入口样式是：
Spline Actor（场景中的样条线） | v Spline Data 节点（自动读取场景样条线） | v Surface Sampler（在样条线区域内撒点）样条线的好处是边界自由，可以画成不规则形状，比矩形 Volume 自然得多。
4.2 搭建 PCG 图主体：树木与岩石
在 PCG_Demo 中创建如下节点链路：
Spline Data | +--> Surface Sampler（大树采样） | +--> Transform Points（随机旋转与缩放） | +--> Static Mesh Spawner（树木） | +--> Surface Sampler（岩石采样） +--> Transform Points +--> Static Mesh Spawner（岩石）先做树木层。
Surface Sampler 参数建议：
- Point Density：200 左右。
- Seed：随意，比如 1001。
Transform Points 参数建议：
- Scale Min：0.8。
- Scale Max：1.2。
- Rotation 勾选 Yaw，范围 0 到 360。
Static Mesh Spawner 中添加树木资产。如果有多种树木，可以在 Mesh Entries 里添加多项，并设置权重。
岩石层与树木层类似，但密度更低、缩放更随机。岩石的生成范围可以先用同一条样条线，后面再用密度和距离过滤器区分。
此时可以先运行一次生成，观察效果。如果你看到树木凭空生成在场景中，说明链路没问题；如果没有任何生成结果，优先检查 PCG Actor 是否选中了正确的图，以及样条线是否被正确连接。
4.3 小屋周围留白：距离过滤
森林小屋周围如果直接长满树，视觉上会很板，而且阻碍玩家行走。需要按照“离小屋越近，树木越少”的规则过滤点。
实现思路是使用 Distance 节点计算每个点到小屋的距离，再用 Density Filter 处理。
具体操作：
- 在场景中记录小屋的坐标。
- 在 PCG 图中添加 Construct Points 节点，手工创建一个点，位置设为小屋坐标。
- 添加 Distance 节点，输入分别为“Surface Sampler 的点集”和“小屋位置点集”。
- 添加 Density Filter，设置过滤规则为“距离小于 5 时删除”。
Density Filter 的常用模式：
| 模式 | 行为 |
|---|---|
| Greater | 保留距离/密度大于指定阈值的点 |
| Less | 保留距离/密度小于指定阈值的点 |
| GreaterOrEqual | 大于等于 |
| LessOrEqual | 小于等于 |
树木层使用“Greater”，保留距离小屋 5 米以外的点。岩石层可以保留 3 米以外的点。草和蘑菇可以不受这个规则限制，或者使用更小的阈值。
这一步是森林小屋场景中最关键的规则之一。没有距离过滤，小屋会被树包围；过滤太狠，森林又会显得中间空一大圈。建议先设 5 米，再根据实际效果反复调整。
4.4 细节层：灌木、草与蘑菇
主体树木完成后，开始丰富植被层次。
灌木层复用树木的链路，但注意密度要低许多，Scale 也可以更小。灌木适合分布在树下和岩石旁，这样视觉上有承接关系。
草层有两种做法：
- PCG 生成：适合少量装饰草簇，用低密度 Surface Sampler 加 Static Mesh Spawner。
- Landscape Grass Type：适合大量草地，希望运行时有更好性能时使用。
本文案例中，使用 PCG 生成草簇，设置非常低的密度，比如 50，Scale 固定在 1 左右。草的变换不需要随机旋转太大，因为草簇本身没有明显的正面朝向。
蘑菇层是非常好的点缀。蘑菇的生成逻辑可以基于树木点集：先用 Distance 节点计算到树木的距离，再利用 Density Filter 保留距离树木 0 到 2 米范围内的点。这样可以做出“蘑菇喜欢长在树根附近”的细节。
蘑菇链路示意：
树木点集 | v Distance（点到树木的距离） | v Density Filter（保留距离小于 2 米的点） | v Transform Points（随机旋转） | v Static Mesh Spawner（蘑菇资产）这一步完成之后，森林小屋的环境层次已经比较完整了：中心小屋、外围乔木、树下灌木、点缀蘑菇。
4.5 运行验证与微调
点击 PCG Actor 上的 Generate 按钮，或者直接运行游戏，查看结果。重点检查几个方面：
- 树木有没有大面积穿模。
- 小屋正前方是否被树木遮挡视野。
- 岩石有没有悬浮在空中。
- 蘑菇是否集中出现在树根附近。
微调时不需要重新摆场景，只需要修改 PCG 图参数：
- 密度高了就降低 Point Density。
- 缩放过大会导致穿模，调小 Transform Points 的 Scale Max。
- 小屋周围树太多，加大距离过滤阈值。
- 树木过于整齐，增大随机旋转和随机缩放的幅度。
调试阶段可以使用 UE 自带性能统计命令，在控制台输入：
stat unit stat gpu观察 PCG 生成是否造成帧率压力。如果帧率下降明显，优先检查静态网格实例数量是否过多，以及是否开启了复杂的碰撞。
另外，如果你已经有一套完整的资产，想把资产列表快速检查一遍，可以用 UE 的 Python 编辑器脚本辅助处理。以下脚本可以列出指定目录下的所有静态网格资产：
import unreal # 按自己项目的目录结构修改路径 asset_path = "/Game/StarterContent/Props" registry = unreal.AssetRegistryHelpers.get_asset_registry() asset_data_list = registry.get_assets_by_path(asset_path) for data in asset_data_list: asset = data.get_asset() if isinstance(asset, unreal.StaticMesh): print("StaticMesh:", asset.get_name())这个脚本只是示例思路，不同 UE 版本对 Python API 的支持有差异，如果在本机报错，以当前编辑器提示的接口为准。
5. 常见问题与排查思路
5.1 高频问题对照表
| 问题现象 | 常见原因 | 解决思路 |
|---|---|---|
| PCG Actor 点击生成后毫无反应 | PCG Graph 未正确指定，或样条线未连接 | 检查 Actor 的 Graph 属性，重新连接输入 |
| 树木生成到小屋房顶或内部 | 没有做距离过滤，或过滤阈值太小 | 增加 Distance 和 Density Filter，调大阈值 |
| 生成结果每次都不一样 | 没有锁定随机种子 | 在相关节点设置固定 Seed |
| 运行时卡顿明显 | 生成实例过多，或碰撞过于复杂 | 降低密度，生成后烘焙，简化碰撞 |
| 树木明显穿模 | 缩放随机范围过大，碰撞检测不充分 | 调小 Scale Max，检查资产轴心和碰撞 |
| 草和灌木过度密集 | Point Density 过高 | 降低密度，或使用 Landscape Grass 替代 |
| 编辑器里正常，运行后不生成 | PCG 生成模式设置为 Editor Only | 修改 PCG Component 的生成模式 |
5.2 典型排查步骤
如果你遇到“生成不出来”的问题，按以下顺序排查：
- 确认 PCG Actor 在场景中存在，并且 Details 面板中指定了 PCG Graph。
- 打开 PCG 图，点击左上角 Generate 按钮，观察节点上有没有报错标记。
- 在视图模式中切换为 PCG Debug 显示，查看点的分布。
- 确认输入数据源正确，比如样条线 Actor 没有被隐藏或删除。
- 将 Static Mesh Spawner 暂时换成最简单的 Cube 资产，排除资产本身的问题。
如果更换为 Cube 后可以生成，问题大概率出在资产上：可能是资产碰撞类型导致生成失败，也可能是资产路径没有被正确引用。
5.3 如何避免再次出现
最重要的习惯是：先小范围测试，再大范围生成。第一次使用 PCG 时，不要直接把整片森林全部生成，先在小区域把节点链路和参数调整稳定，再复制到更多区域。
其次，要养成分层生成的习惯。树木一层、灌木一层、草一层、装饰一层，每一层独立控制，出问题时只需要排查对应链路，不用从头开始。
6. 最佳实践与工程建议
6.1 编辑器内生成与运行时生成的取舍
PCG 支持在编辑器内生成静态网格，也支持运行时生成。
编辑器内生成的好处是：生成后可烘焙成普通 Static Mesh Actor，打包后不再依赖 PCG 计算，运行开销几乎为零。适合环境装饰这类静态内容。
运行时生成适合需要动态变化的场景，比如根据玩家位置动态生成周边植被，或者程序化构建随机地图。但运行时生成会消耗 CPU，尤其在主机端和移动端要严格控制密度。
森林小屋这种固定环境，推荐做法是：
- 在编辑器中反复调试 PCG 效果。
- 确定最终效果后导出或烘焙静态网格。
- 移除运行时 PCG 计算负担。
6.2 资产规范与性能调优
PCG 可以生成几千个实例，资产稍微不规范，性能问题会被放大。
项目实践中的几条具体建议：
- 静态网格尽量开启 Nanite，树木、岩石这类中大型资产收益最明显。
- 所有可生成资产需要合理 LOD，至少保证远距离低模显示。
- 碰撞建议使用简单碰撞，或者直接设为“无碰撞”，尤其是树冠和细碎装饰物。
- 草这类密集资产不要全部依赖 PCG，优先使用 Landscape Grass Type，CPU 压力更小。
- 生成时避免使用过度复杂的贴图分辨率，可以通过项目设置统一限制纹理大小。
另外，PCG 在大范围场景中会产生海量点数据。如果森林范围非常大，可以考虑开启 PCG Partition 功能，把区域切分成多块生成，降低单次计算压力。
6.3 随机与可复现
PCG 的随机性是一把双刃剑。随机能让场景更自然，但制作过程中也容易出现这次生成好看、下次点一下 Generate 就全变了的情况。
强烈建议在项目初始化阶段就确定种子管理规范：
- 每个关键采样节点使用固定 Seed。
- 在 PCG 图属性中统一设置全局 Seed。
- 微调时只改动密度和过滤器参数，不随意改 Seed。
这样既能保证每次结果一致，又保留了参数调整空间。提交版本时，CG 图文件本身就包含了所有生成逻辑，团队协作也比较安全。
7. 总结与学习路线
7.1 本教程掌握的内容
通过这篇教程，你已经亲手完成了一个森林小屋环境的程序化生成流程，掌握了以下核心能力：
- 创建 PCG 图并在 PCG Actor 中正确引用。
- 使用样条线划定生成范围。
- 使用 Surface Sampler 在区域内生成植被点。
- 使用 Distance 和 Density Filter 控制小屋周围留白。
- 使用 Transform Points 控制植被的缩放与朝向。
- 使用 Static Mesh Spawner 生成最终资产。
- 通过锁定随机种子和分层管理保证场景可复现、可维护。
这套流程不只是能用于森林小屋，换任何场景都可以复用。只要把输入区域和资产替换掉，PCG 链路会自动生成新的环境。
7.2 下一步还能学什么
掌握了基础 PCG 链路后，建议按照以下顺序继续深入：
- 学习 PCG 属性标签，用标签分类不同区域，实现“草地稀疏、树下茂密”的规则。
- 学习自定义 PCG 节点，使用 C++ 或蓝图扩展生成逻辑。
- 将 PCG 与 Houdini Engine 对接，用外部程序化结果驱动 UE 场景。
- 研究性能优化，结合 Nanite、ISMC 和 Landscape Grass 做大规模场景。
- 等到场景规模变大后，再深入 PCG Partition 和分布式生成。
就个人练习而言，建议反复做三件事：改密度、改过滤规则、换资产。你会发现器练习过程中最大的收益不是记住某个节点路径，而是逐步培养起“数据流驱动”的场景思维。
PCG 是 UE5 场景流程里值得长期投入的一个方向。建议先从这个小屋案例开始，把距离过滤、密度、随机种子手感调顺，再扩大到整片森林和完整关卡。把生成结果从编辑器烘焙为普通网格或启用 Partition 后，帧率压力会明显小很多。如果你练习时卡在某一步，优先检查三件事：区域是否正确接入样条线、资产是否被 Static Mesh Spawner 正确引用、Seed 是否被手动锁定。这三个问题解决后，PCG 的出片率会高很多。
