unreal-pcg-python

What problem does it solve?

Provides a clear, editor-focused workflow for integrating Python with Unreal Engine's Procedural Content Generation system so developers can automate PCG graph creation, batch generation, and asset manipulation without manual UI steps. It reduces repetitive editor tasks, eases parameter sweeps and CI-friendly asset generation, and documents known constraints so teams avoid runtime or threading pitfalls.

Core Features & Use Cases

• PCGPythonInterop / Execute Python Script: How to enable and use the Execute Python Script node to run inline or file-based Python inside PCG graphs for editor-time orchestration.
• PCG Python API for Editor Automation: Creating PCG graph assets, manipulating PCGComponent on actors, triggering generation, seeding for deterministic outputs, and cleaning up generated content via the unreal Python API.
• Custom Node Guidance: Using PCGBlueprintElement patterns and overridable methods to implement custom node logic, plus when to prefer Blueprint or C++ for performance and stability.
• Practical Limitations & Best Practices: Editor-only constraints, main-thread execution, no direct data output from the Execute Python node, API churn considerations, and recommended uses like batch asset creation and parameter sweeps.
• Use Case Example: Batch-generate level placement points for hundreds of actors, run deterministic sweeps of seeds to produce variant datasets for procedural content, or automate migration of Houdini outputs into PCG assets.

Quick Start

Create a PCG graph asset named MyPCGGraph in /Game/PCG, attach a PCGComponent to the target actors, set seed 42, and run an editor Python script to batch-generate the PCG content across those actors.