1. 项目概述：从零上手Unreal PCG

如果你是一名技术美术、关卡设计师，或者是对程序化内容生成（Procedural Content Generation，简称PCG）充满好奇的开发者，那么Unreal Engine 5的PCG框架绝对是你工具箱里不可或缺的利器。它不是一个简单的“随机撒点”工具，而是一个完整的、基于节点的程序化生成框架，让你能够用可视化的方式，像搭建蓝图或材质一样，构建出从简单物件摆放、到复杂建筑生成、再到整个生物群落乃至世界构建的自动化流程。

简单来说，PCG让你告别手动摆放成千上万棵树、岩石的枯燥重复劳动。通过定义规则和逻辑，引擎可以自动、智能地在你的场景中生成内容，并且这一切都是实时、可迭代的。你调整一个参数，整个森林的布局、密度、大小都会随之动态变化。这对于创建开放世界、大型场景或者需要大量重复但需有自然变化的内容来说，效率提升是颠覆性的。

这个“Unreal PCG 示例项目教程”的核心目标，就是带你亲手搭建一个最经典的PCG应用案例：生成一片程序化森林。我们将从创建一个空白项目开始，一步步构建地形、设置PCG体积、编写PCG图表，直到让树木根据地形自动分布并产生自然的变化。通过这个具体的项目，你将不仅学会PCG的基本操作，更能理解其背后的核心思想：数据（点）的生成、变换与实例化。无论你是PCG的完全新手，还是想系统梳理一下流程的老手，这篇教程都将提供详实的步骤和背后的原理剖析。

2. PCG核心概念与工作流拆解

在动手之前，我们必须先理清PCG框架里的几个核心“黑话”。理解这些概念，后续看图、连线、调参才会心中有数，而不是盲目操作。

2.1 核心概念：点、密度与属性

PCG整个流程可以看作是对“点”数据的加工流水线。

点：这是PCG世界中最基本的单位。你可以把它想象成一个包含了丰富信息的“种子”。每个点不仅仅是一个三维空间中的位置（包含位置、旋转、缩放信息），它还携带了一系列属性，比如颜色、密度、法线方向、随机种子等。后续所有操作，无论是筛选、变换还是生成物体，都是基于这些点进行的。

点密度：这是一个至关重要的概念，它决定了点在某个位置“存在”的可能性。密度值范围在0到1之间，在调试视图中通常显示为从黑到白的渐变。密度为0（黑色）表示该点不会被后续流程处理（相当于被剔除）；密度为1（白色）则表示该点完全有效。很多节点（如密度滤镜）会操作这个值，从而实现基于概率的分布。例如，你可以让山坡上的点密度降低，山谷的密度增高，从而让树木更倾向于生长在山谷中。

属性与元数据：点是数据的容器。属性分为静态属性和动态属性。静态属性是系统预定义的，以$开头，如$Position（位置）、$Rotation（旋转）、$Scale（缩放）。动态属性则是你在图表运行过程中创建和定义的，用于存储自定义信息，比如“树木年龄”、“岩石类型编号”等。这些属性可以在不同的节点间传递和修改，是实现复杂逻辑的关键。

元数据域：属性需要归属于某个“域”，这决定了它描述的是哪种数据。主要域有：

• @Points：点域，最常用，存储每个点自身的属性。
• @Data：数据域，存储整个数据集（如一条样条线、一个体积）的全局属性。
• @Elements：元素域，用于属性集（Attribute Sets），处理更复杂的结构化数据。

理解域能帮助你在正确的上下文中读取和写入属性。在属性选择器中，你会看到类似@Points.MyCustomAttr或$Position这样的写法。

2.2 PCG工作流全景图

一个典型的PCG工作流遵循“输入-处理-输出”的管道模式，对应到图表中就是从左到右的数据流。

1. 输入：首先，你需要告诉PCG系统“在哪里生成点”。这通过采样器节点实现。例如：

   • 表面采样器：在选定的表面（如地形、静态网格体）上生成点。
   • 体积采样器：在一个盒子或球体体积内生成点。
   • 样条线采样器：沿一条样条线路径生成点。 这些节点会输出第一批原始的点数据。

2. 处理：这是PCG图表的“大脑”部分。你通过一系列节点对原始点进行筛选、变换和丰富。常见操作包括：

   • 过滤：根据密度、高度、坡度等条件剔除或保留点。
   • 变换：对点的位置、旋转、缩放进行随机化或规则化调整。
   • 属性操作：创建或修改点的动态属性，为后续逻辑做准备。
   • 空间关系：计算点与点之间的距离，进行聚类或排斥等操作。

3. 输出：最后，你需要将处理好的点“实例化”为场景中可见的物体。这主要通过生成器节点完成，最常用的就是静态网格体生成器。它读取输入的点，并将指定的静态网格体（如树木、岩石、建筑）放置在每个点的位置，并应用该点的旋转和缩放信息。

整个流程在编辑器中是实时可视化的。你可以随时启用任何节点的调试视图，查看该节点输出点的状态，这极大地便利了调试和迭代。

注意：PCG框架是一个插件，默认可能未启用。在创建项目或打开现有项目后，你需要通过编辑 -> 插件，在搜索框中输入“Procedural Content Generation Framework”并勾选启用，然后重启编辑器。

3. 环境准备与项目搭建

现在，让我们开始动手。我将假设你使用Unreal Engine 5.3或更高版本（PCG框架在5.2后趋于完善），并从一个干净的基础开始。

3.1 创建项目与启用插件

首先，启动Unreal Engine，选择游戏类别下的空白项目模板。项目设置中，选择C++或蓝图均可，PCG对两者都支持良好。为项目起一个名字，例如PCG_ForestDemo，并选择合适的存储路径。

项目创建完成后，第一件事就是启用PCG插件。点击菜单栏的编辑 -> 插件，打开插件管理器。在搜索框输入“Procedural”，你应该能看到两个相关插件：

1. Procedural Content Generation Framework：核心插件，必须启用。
2. Procedural Content Generation Framework Geometry Script Interop：用于从静态网格体表面采样点，建议一并启用。

勾选这两个插件后，编辑器会提示需要重启。点击立即重启。重启后，你就能在内容浏览器的右键菜单创建高级资产 -> PCG下看到相关选项，并在放置Actor面板中搜索到PCG体积。

3.2 构建基础场景：地形与光照

我们的森林需要一片土地。在重启后的项目中，创建一个新的关卡（文件 -> 新建关卡），选择基础模板。这个模板会自带一个地板、一个玩家出生点和基本的光照。

我们将用地形工具来创建起伏的山谷，这比一个平面更有助于展示PCG如何适配复杂表面。

1. 删除默认地板：在视口或大纲视图中，选中Floor静态网格体，按Delete键删除。
2. 进入地形模式：在顶部模式面板中，点击地形图标（或按Shift+2）。
3. 创建新地形：在地形管理面板中，点击创建新地形。保持默认设置（材质暂用M_Ground_Grass，若无则任选一个），点击创建。这时场景中会出现一片平坦的地形。
4. 雕刻地形：使用地形雕刻工具，选择雕刻下的平滑或侵蚀笔刷，随意在地形上绘制出一些山丘和山谷。不必太复杂，有基本的起伏即可。这主要是为了后续验证PCG点能正确贴合地形表面。
5. 设置基础光照：基础模板的光照可能较暗。我们可以简单添加一个定向光源（模拟太阳）并调整其角度和强度，再添加一个天空大气和指数级高度雾组件来营造户外氛围。也可以直接使用窗口 -> 环境光混合器来快速应用一个HDRI天空和光照设置。

保存你的关卡，命名为PCG_Forest_Map。

4. 创建第一个PCG图表：森林生成器

核心环节来了。我们将创建PCG体积来定义生成范围，并编写PCG图表来定义生成规则。

4.1 放置PCG体积

PCG体积是一个定义了三维空间的盒子，PCG组件将只在这个体积内部（或表面）执行生成逻辑。这给了你精确的控制能力，避免在整个世界范围内无意义地计算。

1. 在右侧的放置Actor面板中，搜索“PCG Volume”。
2. 将其拖拽到场景中，或者直接点击它，然后在视口中点击放置。
3. 选中这个PCG体积，在细节面板中，找到其变换下的缩放。将其X、Y、Z值均设置为8.0。这样我们就得到了一个边长为800单位（Unreal默认1单位=1厘米）的较大立方体，足以覆盖我们地形的一部分。你可以移动和旋转这个体积，使其覆盖你雕刻出的有趣地形区域。

4.2 创建并连接PCG图表资产

PCG体积只是一个“容器”，真正的生成逻辑保存在独立的PCG图表资产中。

1. 在内容浏览器中，右键点击空白处，选择创建高级资产 -> PCG -> PCG图表。
2. 将新资产命名为PCG_ForestGen，双击打开它。你会进入一个类似蓝图或材质编辑器的界面，这就是PCG图表编辑器。
3. 连接图表到体积：回到关卡视口，确保你的PCG体积被选中。在细节面板中，找到PCG组件部分。点击图表下拉菜单，选择我们刚刚创建的PCG_ForestGen。

至此，PCG体积和生成逻辑已经关联。但此时图表是空的，生成不会有任何效果。

4.3 构建基础生成流程：采样与可视化

让我们从最简单的流程开始：在地形表面生成点，并看到它们。

1. 获取地形数据：在PCG图表编辑器中，右键点击图表区域，在搜索框中输入“Get Landscape Data”，添加该节点。这个节点是输入节点，它从关联的PCG体积所在的位置，去获取关卡中的地形数据。
2. 采样表面点：从Get Landscape Data节点的输出引脚拖拽，释放后搜索“Surface Sampler”（表面采样器），添加该节点并连接。这个节点负责在输入的表面（这里是地形）上生成具体的点。
3. 调试与生成：
   • 选中Surface Sampler节点，按键盘上的D键。这会在该节点上启用调试渲染。启用后，节点标题栏会高亮。
   • 回到关卡视口，确保选中了PCG体积，然后在细节面板的PCG组件部分，点击生成按钮。

如果一切正常，你应该能看到地形表面布满了密集的白色小点（如果地形是深色，点可能显示为黑色）。这些点就是PCG生成的基础数据。它们严格贴合在地形表面，包括你雕刻的斜坡和山谷。

实操心得：D键（调试）和E键（启用/禁用节点）是调试PCG图表最常用的两个快捷键。你可以随时禁用某个节点来看它上游的效果，或者启用某个节点的调试来看它输出的点数据，这比一遍遍生成整个图表要高效得多。

5. 核心节点详解与参数调优

现在我们已经有了基础的点，但它们太规则、太密集了。一片自然的森林，树木的分布应该是疏密有致、位置随机、大小不一的。我们需要通过一系列节点来加工这些点。

5.1 表面采样器参数解析

首先，调整Surface Sampler来改变点的初始分布。

• Points Per Square Meter（每平方米点数）：控制生成点的密度。默认值可能很高（如10），这会导致点过于密集。对于树木生成，我们可以调低到0.1到0.3之间，具体取决于你想要多茂密的森林。我们先设为0.15。
• Points Extents（点范围）：这个参数定义了每个点所占用的空间边界框的大小。它不影响点的位置，但影响后续一些基于范围的计算（如碰撞检测）。通常可以设置为略大于你将要生成的物体的预期大小。对于树木，我们可以设为(500, 500, 500)（单位：厘米），即一个边长5米的立方体范围。
• Looseness（松散度）：控制点偏离完美网格的程度。值为0时，点严格按网格排列；值为1时，点完全随机分布。为了自然感，我们保持其为1.0。
• Sampling Bias（采样偏差）和Sampling Normal（采样法线）：这些高级参数可以控制点更倾向于分布在斜坡的顶部还是底部，或者是否沿着法线方向偏移。对于基础森林，可以暂时不动。

调整后，再次点击生成，你会发现点的数量减少了，分布也变得随机了。

5.2 添加随机变换：Transform Points节点

整齐分布的点依然不自然。我们需要为每个点添加随机的旋转和缩放变化。

1. 在图表中，从Surface Sampler的输出引脚拖拽，添加一个Transform Points节点。
2. 关闭Surface Sampler的调试（选中后按D），然后开启Transform Points节点的调试（选中后按D）。这样我们就能看到经过变换后的点了。

现在来配置Transform Points节点，这是赋予森林“自然感”的关键：

• 位置变换：位置偏移可以给点一个随机的位置偏移。但对于依附于地形的树木，我们通常不希望它们脱离表面，所以这里可以保持为0，或者设置一个很小的值（如Z轴±10厘米）来模拟地面不平。
• 旋转变换：
  • 将最大旋转的Z值设置为360。这意味着每个点会在0到360度之间随机获得一个绕Z轴（垂直轴）的旋转。这是让树木朝向随机的关键。
  • 取消勾选绝对旋转。这个选项非常重要！当它被勾选时，节点的旋转会完全覆盖点原有的旋转。而我们的点从Surface Sampler出来时，其旋转（$Rotation）已经被自动设置为与地形表面法线方向垂直（即“站立”在地面上）。如果我们勾选绝对旋转，就会丢失这个重要的信息，导致所有树都垂直向上，在斜坡上就会“插”进地面。取消勾选后，节点的旋转变换会叠加到点原有的旋转上，从而在保持树木垂直于坡面的基础上，再增加随机的水平朝向。
• 缩放变换：
  • 将最小缩放的X, Y, Z值设置为(0.5, 0.5, 0.5)。
  • 将最大缩放的X, Y, Z值设置为(1.2, 1.2, 1.2)。
  • 这意味着每棵树的大小会在50%到120%之间随机变化。注意，这里使用的是均匀缩放（三个轴联动），你也可以取消勾选统一缩放来分别设置每个轴，制造更扭曲的形态，但对于普通树木，统一缩放更自然。

调整完毕后，点击生成。现在观察调试点，你会发现它们有了不同的大小和朝向，但依然稳稳地“站”在斜坡上。

5.3 生成静态网格体：Static Mesh Spawner节点

点数据已经准备就绪，最后一步就是把它们变成真正的树木模型。

1. 从Transform Points节点的输出引脚拖拽，添加一个Static Mesh Spawner节点。
2. 我们需要为这个生成器指定要生成什么模型。在内容浏览器中，你需要有树木的静态网格体资产。如果你是空白项目，可以去Quixel Bridge（Epic的免费高精度资产库）中下载一些免费的树木模型，或者使用引擎自带的初学者内容包里的简单模型。
3. 选中Static Mesh Spawner节点，在细节面板中找到Mesh Entries（网格条目）。点击旁边的+号添加一个条目。
4. 展开新添加的条目[0]，再展开其下的Descriptor，你会看到Static Mesh属性。点击下拉箭头，从内容浏览器中选择你的树木模型。
5. 重要：设置种子。在Mesh Entries下方，找到Seed（种子）参数，给它一个任意数字，比如12345。PCG的随机性是基于种子的，固定的种子能保证每次生成的结果是确定性的（即相同的输入产生相同的输出）。这对于版本控制和调试至关重要。如果你希望每次生成都不同，可以将其绑定到一个变量或使用随机流节点。

现在，点击生成！你应该能看到树木出现在之前那些点的位置上，并且继承了点的随机旋转和缩放，一片具有基础自然变化的小树林就诞生了。

注意事项：Static Mesh Spawner有一个密度阈值属性，默认是0.5。这意味着只有点密度大于等于0.5的点才会被生成。我们之前没有调整过点密度，所有点的密度默认都是1，所以全部被生成了。如果你后续使用了密度滤镜节点降低了某些点的密度，就需要关注这个阈值。

6. 进阶技巧：丰富森林细节

基础森林已经完成，但它还显得单调。我们可以通过一些进阶操作来大幅提升真实感和可控性。

6.1 添加多种树木与权重控制

一片森林不可能只有一种树。我们可以让PCG同时生成多种树木，并控制它们出现的比例。

1. 在Static Mesh Spawner节点的细节面板，Mesh Entries处继续点击+号，添加第二个、第三个条目。
2. 为每个条目选择不同的树木模型。
3. 关键参数：Weight（权重）。系统会计算所有条目权重的总和，然后用每个条目的权重除以总权重，得到该条目被选中的概率。例如，你有三种树，权重分别设为7, 2, 1，那么总权重是10，第一种树被选中的概率是70%，第二种是20%，第三种是10%。通过调整权重，你可以模拟森林中不同树种的分布比例。

6.2 基于坡度与高度的密度控制

在现实中，树木不会长在过于陡峭的悬崖上。我们可以使用Density Filter（密度滤镜）节点来实现。

1. 在Surface Sampler和Transform Points节点之间插入一个Density Filter节点。
2. 这个节点可以根据点的属性来调整其密度值。我们需要一个能反映坡度的属性。幸运的是，Surface Sampler节点输出的点自带一个$Steepness（陡度）属性，其值在0（平坦）到1（垂直）之间。
3. 在Density Filter节点的细节面板，找到Density Function（密度函数）。将其模式从Constant改为By Attribute。
4. 在Attribute（属性）中，输入$Steepness。
5. 现在，我们需要一个函数，将陡度映射到我们想要的密度上。我们希望陡度越大，密度越小。点击Density Function旁边的...按钮，可以创建一个曲线或表格。一个简单的方法是使用One Minus操作：密度 = 1 - 陡度。这样，平地上（陡度0）密度为1，悬崖上（陡度1）密度为0。你可以在Density Function的设置中通过数学表达式节点来实现这个计算，或者使用一个Float Curve（浮点曲线）来更精细地控制映射关系。

经过这个节点处理后，陡坡上的点密度会降低甚至归零，后续的Static Mesh Spawner会根据其密度阈值（默认0.5）将其过滤掉，从而实现不在陡坡上种树的效果。

6.3 使用子图表与参数化

当你的森林生成逻辑变得复杂时，图表会显得杂乱。PCG支持子图表功能，你可以将一部分常用逻辑（例如“处理单棵树的大小变化”）封装成一个子图表，然后在主图中像使用一个节点一样使用它，这极大地提高了复用性和可读性。

更重要的是图表参数。你可以将一些需要频繁调整的数值（如树木密度、最大最小缩放）暴露为参数。

1. 在PCG图表编辑器的工具栏，点击图表设置按钮（齿轮图标）。
2. 在细节面板的参数部分，点击+号添加参数。
3. 命名参数，如Tree_Density，类型选择Float（浮点数）。
4. 回到图表，选中Surface Sampler节点，找到Points Per Square Meter参数。点击其右侧的引脚图标，将其提升为参数绑定。然后在弹出的菜单中选择我们创建的Tree_Density参数。
5. 现在，你不仅可以在图表内部调整这个参数，更可以在PCG图表实例上进行覆盖。在内容浏览器中右键点击PCG_ForestGen资产，选择创建PCG图表实例。打开这个实例，你就能直接修改Tree_Density等暴露出来的参数，而无需修改原始的主图表。这对于美术和设计师进行快速迭代和创建变体（如稀疏林和密林）非常有用。

7. 性能优化与常见问题排查

程序化生成功能强大，但如果不加注意，也可能导致性能问题。以下是一些优化技巧和常见坑点。

7.1 性能优化要点

1. 控制点数量：这是最重要的因素。Points Per Square Meter不要盲目设高。先以较低密度测试，满意后再逐步提高。记住，每个点最终都可能对应一个需要渲染的网格体实例。
2. 使用LOD与HLOD：确保你生成的静态网格体拥有良好的LOD（细节层次）。在PCG中，你可以利用Unreal Engine 5的World Partition和HLOD系统。将PCG体积分配到特定的数据层和HLOD层，PCG生成的Actor会自动继承这些设置，从而在远距离时合并为HLOD，大幅提升渲染性能。
3. 合理使用生成范围：PCG体积不要无谓地放大。只覆盖需要生成的区域。对于超大型世界，可以考虑使用多个PCG体积分区管理。
4. 简化测试图表：在调试和迭代阶段，可以暂时禁用复杂的节点（如某些滤镜、后期处理），或者使用Debug节点只输出部分结果，以加快生成速度。
5. 注意碰撞：如果生成的树木等物体带有复杂碰撞，数量巨大时会严重影响物理性能。考虑使用简化的碰撞体，或者在不需要物理交互时禁用碰撞。

7.2 常见问题与解决方案

下面是一个快速排查指南：

7.3 调试技巧实录

PCG强大的调试可视化是其一大优点。除了常用的D（调试渲染）和E（启用/禁用），还有几个高级技巧：

• 属性检查器：在图表编辑器的右下角，有Attributes List（属性列表）。当你选中某个节点并点击生成后，点击列表上方的Inspect（检查）按钮，或选中节点按A键，这个列表会显示该节点输出的所有点及其所有属性值。这对于验证自定义属性是否正确计算至关重要。
• 调试树：在编辑器左下角的Debug Tree面板，它以树状结构展示了当前PCG组件的生成层级。你可以在这里快速选择场景中由PCG生成的Actor，或者查看不同节点的输出数据状态。
• 按类别过滤节点：在图表编辑器中，你可以通过顶部的节点类别筛选下拉菜单，快速找到特定类型的节点，这在处理复杂图表时非常方便。

通过这个从零开始的森林示例项目，我们走完了PCG的标准工作流：从概念理解、环境搭建、图表创建、核心节点使用，到进阶优化和问题排查。PCG的魅力在于其无限的可能性，掌握了这些基础，你就可以举一反三，去尝试生成河流旁的岩石、城市中的建筑群、星空中的星云，将创意通过规则和逻辑转化为庞大的虚拟世界。关键在于多动手实验，从简单的规则开始叠加，并善用调试工具观察每一步的数据变化。