# Proxy, Morph, and Preview Settings

Use runtime-budget overrides only for diagnostics or an explicit per-Actor requirement; ordinary content should follow Project Settings.

## Planet Proxy Component

### Presentation and generation

| Setting | Default | Purpose |
| --- | --- | --- |
| `bShowPlanetProxy` | true | Shows the whole-planet proxy, including completion. |
| `PlanetSphereMeshOverride` | None | Advanced Static Mesh used instead of the generated planet visual. |
| `bReversePlanetSphereCulling` | false | Reverses sphere culling. Use it only for an asset whose winding/material contract requires the opposite direction. |
| `bShowSectionProxies` | true | Shows baked Section Proxy layers. |
| `bEnableRuntimeSurfaceCutout` | true | Cuts the planet surface under Section regions at runtime. |
| `bEnableRuntimeProxyPadding` | true | Generates/shows runtime proxy padding while Surface Cutout is enabled. |
| `bAutoRebuildSectionProxiesFromPlanetAsset` | true | Rebuilds proxy layers when Section or bake links change on the Planet Asset. |
| `bAutoRefreshOnRegister` | true | Refreshes presentation from Asset and runtime state when the Component registers. |
| `FallbackRadiusCm` | 100,000 cm, at least 1 | Radius used when a valid Planet Asset radius cannot be resolved. |

### Section Proxy Layer Descriptor

The ordinary workflow generates these entries from the Planet Asset and bake output. Edit them only in an advanced manual construction path.

| Setting | Default | Purpose |
| --- | --- | --- |
| `SectionId` / `LayerId` | None | Stable identities of the owning Section and the layer. |
| `Mesh` / `Material` | None | Layer Static Mesh and optional Material override. |
| `RelativeTransform` | Identity | Layer transform relative to the Planet Proxy Component. |
| `bLayerVisible` | true | Controls visibility of the individual layer. |
| `bPartitionScoped` | false | Couples residency/culling of the layer to a bake partition. |
| `PartitionCoord` | (0,0) | Partition coordinate for a partition-scoped layer. |

### Section Proxy Runtime Budget Override

When `bOverrideSectionProxyRuntimeBudget=false`, the Component uses the project Runtime Budget.

| Setting | Default | Purpose |
| --- | ---: | --- |
| `MaximumSectionProxyPayloadsPerRequest` | 8 | Child payload packages retained by one request. |
| `MaximumSectionProxyDependenciesPerRequest` | 64 | Mesh/material dependencies in one streamable batch. |
| `MaximumSectionProxyComponentsPerFrame` | 2 | New render Components created in one Game Thread frame. |
| `MaximumSectionProxyInstancesPerFrame` | 512 | Instance transforms validated and uploaded in one frame. |
| `MaximumSectionProxyCorrectionVerticesPerFrame` | 4,096 | Morph vertices inspected by Automatic Surface Correction in one frame. |
| `SectionProxyRealizationTimeBudgetMs` | 2.0 ms, at least 0.1 | Shared frame-time limit for correction scanning and Component/Instance realization. |

### Surface Correction Override

| Setting | Default | Purpose |
| --- | --- | --- |
| `bOverrideSectionSurfaceCorrectionSettings` | false | Uses this Actor-wide override instead of per-Section Planet Asset settings. |
| `SectionSurfaceCorrectionMode` | `Disabled` | Chooses `Disabled`, lowest-bake-vertex `Automatic`, or fixed-offset `Manual`. |
| `SectionSurfaceClearanceCm` | 1 cm, at least 0 | Additional outward clearance in Automatic mode. |
| `ManualSectionSurfaceCorrectionCm` | 0 cm, at least 0 | Outward offset applied to all Section Proxies in Manual mode. |

### Debug Overlay

`DebugOverlaySettings` owns the visualization values below.

| Setting | Default | Purpose |
| --- | --- | --- |
| `bShowSectionBounds` | false | Shows Section bounds. |
| `bShowSectionFrames` | false | Shows Section-local frame axes. |
| `FrameAxisLengthCm` | 1,000 cm, at least 1 | Length of displayed frame axes. |

## Transition Morph Component

### Source and morph geometry

| Setting | Default | Purpose |
| --- | --- | --- |
| `ProxyBakeData` | None | Bake Data supplying flat/curved morph payload. A Transition Resource Set normally connects it. |
| `ProxyMeshOverride` | None | Advanced source mesh used instead of the Bake Data proxy mesh. |
| `SourceLODIndex` | 0, at least 0 | LOD read from the override/source mesh. |
| `bUseProxyMeshMaterials` | true | Uses material slots from the source proxy mesh. |
| `TransitionAlpha` | 0, 0–1 | Position along the morph. Runtime transition normally updates it. |
| `bAutoRebuildOnRegister` | true | Rebuilds render/morph representation on registration. |
| `bUseBakeDataPartitionDesc` | true | Uses the projection frame and radius stored in Bake Data. |
| `bOverridePlanetRadius` | false | Uses `PlanetRadiusOverride` instead of the bake/planet radius. Outside diagnostics, this can violate the authored contract. |
| `PlanetRadiusOverride` | 100,000 cm, at least 1 | Curvature radius while override is enabled. |
| `ManualPartitionDesc` | Structure defaults | Origin, East/North/Up axes, radii, and sphere segments used when Bake Data Partition is disabled. |
| `bUseProxyBoundsCenterAsPivot` | false | Uses source-proxy bounds center as morph pivot. |
| `bMoveComponentToPivotOnBuild` | false | Moves the Component itself to the resolved pivot during build. Keep it off when an external transform contract owns placement. |
| `bUseTangentPreservingCurvature` | true | Uses the curvature path that preserves tangent direction and shading continuity. |

### GPU WPO Morph

| Setting | Default | Purpose |
| --- | --- | --- |
| `bUseGpuWpoMorph` | true | Prefers Material WPO-based GPU morphing. |
| `bPreferStaticMeshComponentForGpuMorph` | true | Prefers a StaticMesh Component on the GPU path. |
| `bFallbackToDynamicMeshWhenStaticGpuMorphInflates` | true | Falls back to Dynamic Mesh when rendered Static Mesh vertices exceed the permitted ratio. |
| `StaticGpuMorphMaxRenderVertexRatio` | 1.25, at least 1 | Maximum rendered-to-source vertex ratio for the Static GPU path. |
| `bBuildTransientStaticMeshForGpuMorph` | false | Builds a transient Static Mesh when no GPU asset is assigned. Consider runtime cost and lifetime. |
| `GpuMorphStaticMeshAsset` | None | Prebuilt Static Mesh for GPU morphing. |
| `GpuMorphMaterialOverride` | None | One GPU morph Material override for every slot. |
| `GpuMorphMaterialOverrides` | Empty | Per-slot GPU morph Material overrides; these are more specific than the single override. |
| `GpuMorphAlphaParameterName` | `PlanetXMorphAlpha` | Scalar Material parameter receiving Transition Alpha. It must match the Material exactly. |

### GPU Render Pass Policy

These options affect only PlanetX-owned Transition Morph render Components.

| Setting | Default | Purpose |
| --- | --- | --- |
| `MorphShadowMode` | `FullMorphMesh` | Disables morph shadows or renders the complete morph representation into shadows. |
| `MorphRayTracingMode` | `EvaluateWpo` | Chooses `Disabled`, `StaticGeometry` without WPO, or the more expensive `EvaluateWpo`. |
| `MorphVelocityMode` | `Enabled` | Enables velocity output for accurate motion vectors and temporal effects. |
| `MorphDepthPassMode` | `Enabled` | Enables the depth pass for depth-effect compatibility. |

### Morph performance and visibility

| Setting | Default | Purpose |
| --- | --- | --- |
| `MinimumAlphaChange` | 0.002, 0–1 | Skips a morph update when alpha changes by less than this amount. |
| `bUpdateNormalsDuringMorph` | false | Updates normals with positions on CPU/Dynamic paths. It may improve quality at additional cost. |
| `bUseFastPositionUpdates` | true | Uses position-only updates without rebuilding topology. |
| `bCollectRuntimeMorphDiagnostics` | false | Collects runtime morph diagnostics. Enable it only when needed during performance investigation. |
| `bOverrideTransitionRuntimeBudget` | false | Uses the following Transition-specific values instead of Project Runtime Budget. |
| `MaximumTransitionDependenciesPerRequest` | 64, 1–512 | Dependency limit for one Transition stream request. |
| `MaximumTransitionComponentsPerFrame` | 2, 1–64 | Transition render Components realized in one frame. |
| `TransitionRealizationTimeBudgetMs` | 2.0 ms, 0.1–10 | Game Thread time limit for Transition realization. |
| `bVisibleOnlyDuringTransition` | true | Shows the Morph Component only during Transition state. |
| `bTransitionActive` | false | Current transition-presentation state. Runtime normally owns it, though it is available for manual testing. |

## Runtime Preview Actor

External Level Proxy Bake creates this Actor in the Preview World. It is not a gameplay Actor, and the generation pipeline owns its `PreviewBakeData` link.

| Setting | Default | Purpose |
| --- | --- | --- |
| `PreviewBakeData` | None | Visual-only Bake Data loaded when the Preview World streams in. |
| `bOverrideRuntimeBudget` | false | Uses this Preview Actor's values instead of Project Runtime Budget. |
| `MaximumPayloadsPerRequest` | 8, at least 1 | Child payload limit for one request. |
| `MaximumDependenciesPerRequest` | 64, at least 1 | Dependency limit for one streamable batch. |
| `MaximumComponentsPerFrame` | 2, at least 1 | Component creation limit per frame. |
| `MaximumInstancesPerFrame` | 512, at least 1 | Instance realization limit per frame. |
| `RealizationTimeBudgetMs` | 2.0 ms, at least 0.1 | Frame-time limit for Preview realization. |

Do not duplicate GameMode, Pawn, Controller, gameplay Actor logic, navigation, or Ground gameplay collision into Runtime Preview. Those remain the responsibility of the actual Ground World.