Seed placement
Settings uses an integer random seed for the generation choices. The actor adds randomly distributed roots to any explicit Extra Seeds. With surface snapping enabled, seed offsets are projected onto the selected anchor face, so offsets through the wall do not place roots on the back face.
Swipe the table to read every column.
| Parameter | Default / type | Effect and use |
|---|---|---|
| Random Seed | 20260918 / integer | Controls randomized roots, branching, meander and leaf variation. Record the seed with the complete actor setup. |
| Seed Count | 4 / integer, minimum 0 | Number of generated seed positions. Set 0 to use Extra Seeds only; with no extra seeds the result is empty. |
| Seed Spread Radius | 40 cm / float, minimum 0 | Radius of the random seed distribution before projection onto the anchor surface. |
| Seed Height Jitter | 15 cm / float, minimum 0 | Random local Z offset in the range −value to +value. |
| Cluster Origin | (0, 0, 0) / vector | Actor-local offset used to choose the cluster's surface anchor. |
| Extra Seeds | Empty / vector array | Additional actor-local seed offsets added around the cluster anchor. They supplement Seed Count. |
Path and branch settings
Swipe the table to read every column.
| Parameter | Default / type | Effect and use |
|---|---|---|
| Growth Direction | (0, 0, 1) / vector | Initial direction in actor-local space, normalized before use. Zero falls back to local up. Surface snapping projects growth onto the supporting face. |
| Max Length | 800 cm / float, editor minimum 20 | Base length budget for a root strand. Surface edges and exclusions may stop it earlier. |
| Step Distance | 20 cm / float, minimum 2 | Distance between growth attempts. Lower values sample surfaces more closely and increase generation work. |
| Max Branch Depth | 2 / integer, editor range 0–4 | Maximum generations of side branches. 0 keeps only root strands. |
| Max Branches Per Strand | 3 / integer, minimum 0 | Limits side branches emitted by each strand. |
| Branch Probability | 0.5 / float, range 0–1 | Chance per eligible growth step, reduced toward the tip. It is not a percentage of completed strands. |
| Branch Angle Min / Max | 20° / 60° / floats | Random departure-angle interval to either side of the parent. Keep minimum no greater than maximum. |
| Branch Length Scale | 0.6 / float, editor range 0.05–1 | Multiplies length for each branch depth. Generation clamps the effective factor to 0.1–1 and also reduces branch radius. |
| Wander Strength | 0.35 / float, minimum 0 | Amount of lateral path meander. Reduce for straighter stems. |
| Wander Frequency | 2.5 / float, minimum 0.1 | Frequency of path meander along a strand. Higher values turn more often. |
| Upward Bias | 0.5 / float, range 0–1 | Blends travel direction toward actor-local up before the surface projection. |
| Gravity Sag | 0.25 / float, range 0–2 | Adds increasing actor-local downward influence along the strand. It shapes the generated path; it is not physics simulation. |
The implementation has a shared strand-generation budget per actor. Large requested seed or branching values do not guarantee that every requested branch will be produced.
Compare repeatable variations
- Duplicate a placed actor and keep the same supporting geometry.
- On one copy, change only Random Seed and regenerate to compare randomized layouts.
- Restore the seed, then vary Max Branch Depth, Branch Probability or Branch Length Scale to compare structural changes.
- Use Extra Seeds with Seed Count = 0 when roots need deliberate placement. Rebuild after each adjustment and inspect the projected roots.