用途
PCG 技能文档面向 Unreal Engine 5.7 中的程序化内容生成(PCG)图资源,说明如何通过原生 PCG Python API 脚本化地创建、检查与编辑 PCG 图。文档指出 UE 5.7 的 PCG 已可用于生产环境,且可通过 PCGPythonInterop 插件完整脚本化,无需 VibeUE 服务封装。
主要能力
- 创建 PCG 图资源(使用 unreal.PCGGraphFactory 与 AssetTools)
- 加载已有 PCG 图,或通过 Asset Registry 搜索 PCGGraph 资产
- 使用 add_node_of_type(SettingsClass) 添加节点,返回 (PCGNode, PCGSettings) 元组
- 读取与修改节点设置(set_editor_property / get_editor_property)
- 通过设置类名识别节点,并通过 get_input_node / get_output_node 访问输入输出节点
- 枚举可用的 PCG 设置类(dir(unreal) 中以 Settings 结尾且含 PCG 的属性)
- 连接引脚、定位与删除节点、放置 PCGVolume 并生成内容、子图等操作在配套的 workflows.md 中说明
- 设置属性名称、Static Mesh Spawner 配置、常见节点设置类在 reference.md 中说明
- 示例脚本 scripts/build_pcg_graph.txt 可通过 execute_python_code 运行,创建图并添加 Surface Sampler 与 Static Mesh Spawner 节点
使用方式
需在项目 .uproject 中启用 PCG 与 PCGPythonInterop 两个插件,并用 assert hasattr(unreal, 'PCGGraph') 验证插件已加载。创建图时先通过 factory 创建资产并保存;添加节点时直接使用 unreal 模块下的设置类,无需 find_class。文档强调修改图后应始终执行“保存 → 重新加载 → 重新指派 → 生成”流程,并建议在添加节点前先检查已有节点类型以避免重复。
适用场景
适用于需要在 UE 项目中以脚本方式搭建设备、装配或自动化构建 PCG 图的工作流,例如从采样器到静态网格生成器的完整链路搭建,以及空关卡或稀疏关卡中使用 Volume Sampler 进行生成的场景。
限制与注意事项
文档列出了若干容易导致无限重试循环的错误:不要对任何 PCG 类调用 discover_python_class 或 discover_python_function;Volume Sampler 的输入引脚名为 “Volume” 而非 “In”;voxel_size 是 Vector 而非 float;PCGComponent 的 graph 属性受保护,应使用 pcg_comp.set_graph(graph);每次修改后必须保存并重新加载;空关卡应使用 Volume Sampler(unbounded=True)而非 Surface Sampler;不要为验证网格或材质而生成测试 Actor,可通过 InstancedStaticMeshComponent 的实例计数验证。此外,PCGGraph.is_standalone_graph 已弃用(issue #465),应改用 GraphUsageContext 或使用标志区分顶层图与子图。