Skip to content

Getting Started

This guide walks you through installing Procedural Placement Graph and creating your first placement graph.

Creating Your First Graph

Step 1: Create a Graph Asset

  1. Right-click in the Project window
  2. Select Create > Procedural Placement Graph > Graph Asset
  3. Name it (e.g., MyFirstGraph)

Step 2: Open the Graph Editor

  1. Double-click the graph asset, or
  2. Open Window > Procedural Placement Graph > Graph Editor and drag the asset into the window

Step 3: Add Nodes

  1. Right-click in the graph editor to open the Search Window
  2. Add a Random Points node (Generators category)
  3. Add a Prefab Instancer node (Instancers category)
  4. Connect the Out port of Random Points to the In port of Prefab Instancer

Step 4: Configure Nodes

  1. Select Random Points and set:
    • pointCount: 50
    • boundsMin: (-10, 0, -10)
    • boundsMax: (10, 0, 10)
  2. Select Prefab Instancer and assign a prefab to the prefab field

Step 5: Set Up the Scene

  1. Create an empty GameObject in your scene
  2. Add a PPG Component (Add Component > PPG Component)
  3. Assign your graph asset to the Graph field
  4. Click Generate

Your prefabs should now be scattered within the defined bounds.

Auto Preview

Toggle Auto in the graph editor toolbar to automatically re-execute when you change parameters. If a PPGComponent using this graph exists in the scene, Auto mode runs the full graph including instancers (objects are actually placed). If no component is present, it falls back to preview-only mode showing point positions in the scene view.

Next Steps

Procedural Placement Graph for Unity