PlanetX Docsv1.0.1
Language: ENLast audited: 2026-08-23
Configuration ReferenceSource verified

Proxy Bake Settings

Download this pageMarkdown

Basic/Advanced view state, Bake Quality, and the requested Source Representation are stored as editor-user settings.

#1 Target Planet Asset

SettingPurpose
Planet AssetOwns the generated Section and bake link. It supplies planet radius, output identity, projection context, and the final ProxyBakeData link.

Changing the Planet Asset or Source World makes the existing Scan plan stale. Run Scan Sources again for the new target.

#2 Runtime Role

SettingDefaultPurpose
PresentationSame WorldSame World keeps Planet and Ground in one World package and changes presentation. External Level is the UI name for code-level LevelHandoff; it uses a separate Ground World and a visual-only Runtime Preview World.
Ground WorldCurrent Source WorldRead-only value resolved from the World being scanned and baked.
Planet WorldNoneShown only for External Level. Select the Orbit World that owns the destination Planet Actor on return from Ground. It must be a saved World distinct from Ground World.

The default Level Handoff backend contract is OpenLevel. PlanetX captures and resumes state, but the game remains responsible for Open Level, Pawn creation, and possession.

#3 Source Scope

SettingDefaultPurpose
Selected ActorsScans only Actors currently selected in the Outliner or viewport. Appropriate for deliberate partial bakes.
Current LevelSelectedScans Actors owned by the current persistent Level and excludes streaming Levels.
Loaded LevelsScans the current Level, loaded streaming Levels, and Level Instances.
Reviewed SetReuses stable source membership explicitly reviewed in the current plan. Complete a Scan with another scope first.
Source Representation: Prefer HLODSelectedPrefers validated World Partition HLOD and falls back to original Actors when the source contract requires it.
Source Representation: Original ActorsUses original Actors and Components only. This is useful for HLOD comparison or fidelity diagnosis.
Include all tagsEmptyIncludes only sources whose Actor has every comma-separated tag. Empty means no include filter.
Exclude any tagEmptyExcludes a source when its Actor has any listed tag.

Contracts that require exact membership—Selected Actors, Reviewed Set, or tag filtering—may resolve an effective Original Actors policy even when Prefer HLOD was requested. Check the requested/effective summary in the UI.

#Source Review

FieldPurpose
UseIncludes or excludes the source from the current bake.
Role: AutoUses the role selected by Scan classification.
ProxyGeometryBuilds ordinary geometry, such as Static Mesh content, into proxy meshes.
LandscapeProxyUses the Landscape-specific capture and material path.
InstanceBatchPublishes repeated ISM/HISM/Foliage instances as batch output.
DiscardIntentionally omits the source from output.
ManualReviewScan could not establish safety automatically. Review the reason, then repair or exclude it.
UnsupportedThe current pipeline cannot publish the source safely. Leaving it enabled blocks Bake.
Group ScopeApplies review changes by Actor, Folder, Data Layer, or Level/Level Instance.

After changing Use or Role, choose Apply Source Changes to rebuild the plan. Safety findings for WPO/displacement, private material dependencies, or unsupported deformation can be blocking decisions rather than informational warnings.

#Bake Quality

Quality is an immutable authoring preset recorded in the generated revision.

PresetStatic Mesh triangle budgetProjection scale / max segmentsLandscape spacing / resolution
Low1× coarsest LOD4.0 / 8800 cm / 17–129
Medium2× coarsest LOD2.0 / 12600 cm / 25–193
High (Recommended)4× coarsest LOD1.0 / 16400 cm / 33–257

High does not mean an unbounded source LOD. It selects the finest valid LOD within a multiple of the coarsest valid LOD's triangle count, keeping geometry growth bounded.

#Advanced Projection and Output Plan

SettingDefault / rangePurpose
Partition X, Partition YPlan value, at least 1 cmOutput partition dimensions. They are disabled while World Partition auto-sizing is active.
Planet RadiusTarget Asset value, read-onlyRadius in centimeters used by AEQD projection, curvature classification, and subdivision.
Source GridfalseUses source Landscape vertex resolution instead of the low proxy grid. It can substantially increase output and processing cost.
Surface Datum World Z: AutoOnUses the minimum World Z of participating source bounds as altitude zero and the Ground Sync datum.
Surface Datum World ZPlan value, cmManual world-space Z treated as altitude zero when Auto is off. Changing it requires plan recalculation.
Auto-size World Partition Outputtrue for WPDerives PlanetX output-shard dimensions from source bounds and work density. It does not mirror World Partition cells one-to-one.
RecalculateRecomputes the automatic grid from the latest Scan.

Output path, Target Section, Bake ID, and Source/Partition/Geometry summaries are resolved results. If the target conflicts with an existing asset, the editor requires explicit overwrite or rebuild consent.

#Advanced Execution Budget

SettingDefault / rangePurpose
Auto Memory BudgettrueResolves a safe RAM budget from currently available physical memory. Recommended for ordinary work.
SafeSelectedKeeps 4 GiB of physical memory unavailable to Proxy Bake.
High UtilizationKeeps only 1 GiB free. Select it explicitly for a dedicated bake run; commit and finalization guards remain active.
Manual GiBDisabled under Auto, 0.5–1024Total manual memory budget used when Auto is off.
Workers0, 0–64Geometry worker limit. Zero lets the memory governor choose concurrency.
Queued8, 1–128Maximum number of bounded work packets waiting concurrently.
GT Finalize4, 1–32Maximum Game Thread publication/finalization backlog.
Worker GeometrytrueRuns value-only geometry on worker tasks while UObject reads and publication stay on the Game Thread.

Higher values are not always faster. After Scan, review the top contributor and remediation text. For memory pressure, inspect Auto Memory Budget and the partition plan before increasing worker, queue, or finalization limits.

#Public advanced option: FPlanetXProxyBakePartitionDesc

This structure is the projection contract used by Transition Morph and public C++ paths. The ordinary editor workflow generates it from the target Asset and plan.

SettingDefaultPurpose
PartitionOrigin(0,0,0)Origin of the flat partition frame.
PartitionEast / PartitionNorth / PartitionUpForward / Right / UpOrthogonal axes of the partition frame.
PlanetRadius100,000, at least 1Planet radius for curved projection.
PartitionRadius10,000, at least 1Valid radius of the partition.
SphereLatitudeSegments / SphereLongitudeSegments250 / 250, at least 3Fixed sphere-surface sampling resolution.

#Public advanced option: FPlanetXProxyBakeOptions

The editor quality preset and source classifier resolve these values in the normal user workflow. Set them directly only in a tool that calls the public API.

SettingDefaultPurpose
LODIndex0, at least 0Explicit Static Mesh source LOD. Do not mix it with editor quality selection unintentionally.
bSkipHiddenComponentstrueOmits hidden Components.
bWarnOnNonUniformScaletrueReports non-uniformly scaled sources.
bSkipNoBakeTaggedActorstrueOmits Actors carrying the PlanetX NoBake tag.
bRequireBakeSourceTagForSingleLevelfalseRequires the BakeSource tag even for a single-Level bake.
bFailOnAeqdRangeExceededtrueFails outside the safe AEQD projection range. Keeping the default avoids silently publishing distorted output.
bClipTrianglesToPartitionRadiusfalseClips triangles at the partition radius. Use only for output intentionally different from canonical ownership.
LandscapeProxyMaterialNoneFallback when the source Landscape material cannot be used by a Static Mesh proxy.
SubdivisionWorldStep275 cm, at least 0Base world-space subdivision interval.
AdaptiveSubdivisionMaxProjectedEdgeDeviationCm5 cm, at least 0Allowed curved-projection edge deviation.
MaxSubdivisionDivisionsPerTriangle24, at least 1Subdivision limit for one source triangle.
MaxOutputTrianglesPerBakeJob5,000,000, at least 1Final triangle safety limit for one bake job.

FPlanetXProjectionResult, material remaps, heightfields, mesh pages, partition output, and instance-batch structures are generated payloads. They are not user settings even where their properties are reflected.