PolyTerrain components
All editor components appear under category Poly Terrain. Runtime mirrors exist for play / cooked content; authoring usually adds the editor-wrapped variants.
Shared modifier fields (every modifier component):
| Field | Default | Purpose |
|---|---|---|
| Enabled | true | Skip evaluation when false |
| Priority layer | (string) | Must match an MPD layer name |
| Sub-priority | 0 | Order within the layer (ascending) |
| Target partition | empty | Partition entity; empty = host entity |
Full brush / procedural parameters: Modifiers.
Poly Partition
Display name: Poly Partition. Root of authoring.
| Field / action | Typical default | Purpose |
|---|---|---|
| Definition asset | — | MPD (.polypartitiondefinition) |
| Auto generate plane | on | Implicit grid Base Sections |
| Section count X / Y | — | Grid layout when auto-generating |
| Section size | 64 m | Section edge length |
| Vertices per edge | 65 | Plane density |
| Source export folder | — | Where .polypartition sources are written |
| Preview material path | — | Optional preview material override |
| Auto build on save | off | Incremental BuildCompiledSections on level save |
| Build Compiled Sections | action | Export + AP bake |
| Convert Selected Mesh | action (Edit Tab) | Replace Base with selected mesh LOD0 |
| Refine / Coarsen Section | action | Local density edit on selected section |
Poly Partition Runtime Section
Display name: Poly Partition Runtime Section. Shows a baked section at runtime (often injected by PrefabProcessor).
| Field | Purpose |
|---|---|
| Compiled section asset | .polypartitionsection |
| Weight channel asset | .polypartitionweights (optional) |
| Material path hint | Display material override hint |
| Anchor baked into entity | When true, entity transform already carries the world anchor |
Poly Partition Collision
Display name: Poly Partition Collision. Static rigid body from baked collision mesh (triangle or convex hulls from the Transformer).
| Field | Purpose |
|---|---|
| Collision layer override | Optional physics layer name; empty uses baked layer |
Requires a sibling / same-entity Runtime Section with collision data in the compiled asset. Cooks via AzFramework physics APIs (PhysX when that backend is present).
Poly Partition Surface Data
Display name: Poly Partition Surface Data. Registers a SurfaceData provider from the compiled mesh + weight textures for vegetation / gameplay tags.
| Field | Typical default | Purpose |
|---|---|---|
| Default surface tag | poly_terrain | Tag when no channel mapping hits |
| Channel mappings | — | Weight channel name → surface tag |
| Priority | 1 | SurfaceData creator priority (higher wins at same point) |
Poly Partition Heightfield Bridge
Display name: Poly Partition Heightfield Bridge. Editor-only bridge to heightfield terrain.
| Field / action | Purpose |
|---|---|
| Sample Heightfield Into Base Sections | Bake GetHeightD into explicit Base Sections |
| Missing terrain height | Fallback Z where heightfield has no data |
| Export Heights To Image Gradient | Rasterize preview heights into an Image Gradient |
| Sync Collision Exclusion Regions | Punch holes in heightfield colliders under the partition footprint |
| Auto sync exclusion | Debounced re-sync on transform / preview rebuild |
| Exclusion padding | XY padding (m) around section footprints |
See Integrations.
Poly Partition VT Volume
Display name: Poly Partition VT Volume. Runtime virtual texture coverage (requires Box Shape on the same entity). Opt-in: VtEnabled.
| Field | Purpose |
|---|---|
| VT asset | .vt atlas / page-table settings |
| Fallback color | Color when sampling misses |
| Fallback material hint | Optional material base.color override for fallback |
Poly Partition VT Trail Emitter
Display name: Poly Partition VT Trail Emitter. Stamps VT trails as the entity moves (or via SubmitTrailStamp).
| Field | Purpose |
|---|---|
| Radius / color / opacity / hardness | Stamp disk appearance |
| Spacing | Distance between automatic stamps |
| Normal flatten / roughness delta | Optional Normal / Roughness plane writes |
| Weight slot values / strengths | Optional weight-plane stamp (when .vt enables weight plane) |
Modifier components (summary)
| Display name | Writes |
|---|---|
| Poly Partition Sculpt Modifier | Geometry |
| Poly Partition Weight Paint Modifier | Weights |
| Poly Partition Boolean Modifier | Topology |
| Poly Partition Spline Modifier | Geometry |
| Poly Partition Noise Modifier | Geometry or weight |
| Poly Partition Texture Modifier | Geometry or weight |
| Poly Partition Remesh Modifier | Topology |
| Poly Partition Mesh Projection Modifier | Geometry |
| Poly Partition Patch Modifier | Geometry + weight |
| Poly Partition Subsection Hint Modifier | Metadata (subsection AABB hints) |
| Poly Partition Heightfield Blend Modifier | Geometry (blend toward heightfield) |
| Poly Partition PCG Write Modifier | Geometry (Query→Write point pairs) |
Add via Modifiers Tab, Outliner palette, Entity Inspector (Poly Terrain), or Landscape Canvas Poly Terrain nodes. Parameter details: Modifiers.