Create the actor
- In Place Actors, search for Procedural Vine Actor and place one beside a wall or curved vertical mesh. Keep its scale at (1, 1, 1) while tuning dimensions.
- The target mesh must block the actor's Settings → Surface Trace Channel (default WorldStatic). Its collision must support the selected simple or complex trace mode.
- Position the actor origin just outside the visible face, within Surface Trace Distance (default 150 cm). Do not bury the origin inside the wall. The initial anchor search rejects floor-like surfaces.
- Select the actor itself in Details. Expand Settings. For a clear first test, use Seed Count = 1, Max Branch Depth = 0, and Spawn Leaves = false. These are example values.
- Press Regenerate. Rebuilding is asynchronous; let Is Generating become false before reading final strand counts or saving the completed result.
- Restore branching and leaves gradually. In the Content Browser settings, enable Show Plugin Content and open Procedural Vines Content → Materials. Assign M_VineBark to Stem Material. Assign M_ProceduralLeaves to Leaf Material for procedural quads, or M_LeafInstances for instanced leaf meshes. These materials are assigned manually; unassigned procedural materials use Unreal's default surface material.
- Save the level after generation finishes. Duplicate the actor to reuse settings; change Random Seed for a different arrangement. Recheck surface placement on the duplicate.
Manual and automatic rebuilds
Swipe the table to read every column.
| Parameter | Default / type | Effect and use |
|---|---|---|
| Generate On Construction | true / boolean | Editor placement, movement and property changes request generation. Disable for several edits in a row, then press Regenerate. |
| Regenerate | Editor button / Blueprint call | Cancels any queued job and starts a fresh generation request. Existing geometry remains during path and geometry generation; application occurs in stages. |
| Clear | Editor button / Blueprint call | Cancels generation and removes stored strands, stem geometry and leaves. A later automatic rebuild or Regenerate can create them again. |
| Is Generating | Blueprint boolean | True while a generation request is queued or running, including waiting for geometry application. |
Disabling Generate On Construction is an authoring convenience. Loading the actor reconstructs render data from saved paths when available; Begin Play also queues reconstruction. It is not a bake or a guarantee that no runtime setup occurs.
Read the result
Get Strand Count reports completed stored strands. Get Total Strand Length sums their stored path lengths. The visible mesh is smoothed between those path samples. The Details panel exposes Generated Strands with points, normals, radii, branch depth and total length for inspection.
Same seed, settings, actor transform and surrounding collision produce the same randomized choices. Changing wall geometry, collision, exclusion boxes or the actor transform changes the sampled environment and may change the final shape.
