ue-procedural-generation
Use when generating world content or geometry procedurally in Unreal Engine: PCG graphs, custom PCG nodes in C++, runtime mesh building, instancing and seeded noise. Also use when the user mentions 'PCG', 'UPCGComponent', 'UPCGSettings', 'IPCGElement', 'UPCGBasePointData', 'surface sampler', 'static mesh spawner', 'runtime generation', 'CreateMeshSection', 'UProceduralMeshComponent', 'UDynamicMeshComponent', 'Geometry Script', 'AddInstance', 'HISM', 'spline mesh', 'PerlinNoise', 'FRandomStream', 'scatter foliage' or 'marching cubes'. For collision on generated geometry, see ue-physics-collision; for instance materials, see ue-materials-rendering; for background work, see ue-async-threading.
quodsoler · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add quodsoler/unreal-engine-skills --skill ue-procedural-generationAbout this skill
name: ue-procedural-generation description: "Use when generating world content or geometry procedurally in Unreal Engine: PCG graphs, custom PCG nodes in C++, runtime mesh building, instancing and seeded noise. Also use when the user mentions 'PCG', 'UPCGComponent', 'UPCGSettings', 'IPCGElement', 'UPCGBasePointData', 'surface sampler', 'static mesh spawner', 'runtime generation', 'CreateMeshSection', 'UProceduralMeshComponent', 'UDynamicMeshComponent', 'Geometry Script', 'AddInstance', 'HISM', 'spline mesh', 'PerlinNoise', 'FRandomStream', 'scatter foliage' or 'marching cubes'. For collision on generated geometry, see ue-physics-collision; for instance materials, see ue-materials-rendering; for background work, see ue-async-threading." metadata: version: "2.0.0" engine: "5.8"
UE Procedural Generation
Target engine: UE 5.8. APIs below are verified against the 5.8 headers; older forms are listed under "Deprecated — do not use".
Covers the PCG framework (plugin PCG at Engine/Plugins/PCG, enabled by default, Build.cs module PCG), runtime mesh building with UProceduralMeshComponent (plugin ProceduralMeshComponent, module ProceduralMeshComponent) and UDynamicMeshComponent + Geometry Script (modules GeometryFramework and GeometryScriptingCore), instancing with UInstancedStaticMeshComponent/UHierarchicalInstancedStaticMeshComponent, spline-driven placement, and deterministic noise/random from Core.
Context
Read .agents/ue-project-context.md if it exists (module names, conventions, enabled plugins, GAS/networking setup). Do not stop if it is missing.
Identify the area from the request and the codebase. Ask only when two plausible readings would produce different code.
| Request is about… | Go to |
|---|---|
| Enabling PCG, module/plugin wiring | PCG setup |
| Driving generation from an actor, runtime generation, partitioning | PCG component and runtime generation |
| Reading/writing points inside a graph | Point data |
| Writing a new PCG node in C++ | Custom PCG node in C++ |
| Which node does X, pin labels, node settings fields | PCG node reference |
| Building triangles at runtime | ProceduralMeshComponent |
| Boolean ops, primitives, baking to a static mesh | Dynamic Mesh and Geometry Script |
| Thousands of repeated meshes | Instanced static meshes |
| Roads, rivers, fences, cables | Splines |
| Heightfields, scatter, reproducible results | Noise and deterministic random |
| Marching cubes, BSP dungeons, WFC, Poisson disc | Procedural mesh patterns |
PCG setup
// MyGame.Build.cs
PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "PCG" });
{ "Name": "PCG", "Enabled": true }
| Class | Header | Role |
|---|---|---|
UPCGComponent | PCGComponent.h | Actor component that owns a graph and drives generation |
UPCGGraph | PCGGraph.h | Graph asset: nodes, edges, UserParameters |
UPCGGraphInstance | PCGGraph.h | Graph instance with per-instance parameter overrides |
UPCGGraphInterface | PCGGraph.h | Common base of graph and graph instance |
UPCGSettings | PCGSettings.h | Node settings base class |
IPCGElement | PCGElement.h | The executable half of a node |
FPCGContext | PCGContext.h | Per-execution state: InputData, OutputData, Node, ExecutionSource |
UPCGBasePointData | Data/PCGBasePointData.h | Abstract point collection |
UPCGPointArrayData | Data/PCGPointArrayData.h | Structure-of-arrays point data |
UPCGSubsystem | Subsystems/PCGSubsystem.h | Scheduling, partitioning, runtime generation |
APCGVolume | PCGVolume.h | Volume actor carrying a UPCGComponent |
PCG component and runtime generation
#include "PCGComponent.h"
#include "PCGGraph.h"
void AMyGenerator::StartGeneration(UPCGGraphInterface* Graph, int32 InSeed)
{
UPCGComponent* PCG = FindComponentByClass<UPCGComponent>();
if (!PCG)
{
return;
}
PCG->Seed = InSeed;
PCG->bActivated = true;
PCG->SetGraph(Graph); // NetMulticast, Reliable
PCG->Generate(/*bForce=*/true); // NetMulticast, Reliable
}
| Call | Replication | Use for |
|---|---|---|
Generate(bool bForce) / Cleanup(bool bRemoveComponents) | NetMulticast, Reliable | Server-driven generation that must appear on clients |
GenerateLocal(bool bForce) / CleanupLocal(bool bRemoveComponents) | none | Client-side or single-player generation |
NotifyPropertiesChangedFromBlueprint() | none | Mark dirty and conditionally regenerate after editing exposed properties |
CancelGeneration() | none | Abort an in-flight generation |
GetGeneratedGraphOutput() | none | Read back the FPCGDataCollection the graph produced |
EPCGComponentGenerationTrigger (PCGComponent.h:77): GenerateOnLoad, GenerateOnDemand, GenerateAtRuntime.
Partitioning and runtime generation:
SetIsPartitioned(bool)/IsPartitioned()back thebIsComponentPartitionedproperty; partitioned components dispatch work to local components on a grid.GenerateAtRuntimehands the component to the runtime-gen scheduler. Tune it withSchedulingPolicyClass/SchedulingPolicy(UPCGSchedulingPolicyBase) andbOverrideGenerationRadii+GenerationRadii(FPCGRuntimeGenerationRadii).- Scheduler CVars:
pcg.RuntimeGeneration.Enable,pcg.RuntimeGeneration.NumGeneratingComponents,pcg.RuntimeGeneration.GlobalRadiusMultiplier,pcg.RuntimeGeneration.EnablePooling,pcg.RuntimeGeneration.BasePoolSize, `pcg.RuntimeGeneration.FramesBeforeFirs