INSODIMENSIONStudios
BiomesReference

Biome Asset Reference

Every editable field of the Agentic Biome data asset (UAgenticBiome) and the structs, enums and generator asset it nests, with types, defaults and backend notes

Biome Asset Reference

UAgenticBiome (shown in Unreal as Agentic Biome) is a UPrimaryDataAsset with primary asset type AgenticBiome. One asset holds a biome's identity, its offline species rows, its runtime ground-cover entries and its landscape layer. This page lists every editable property, one table per struct. For the workflow, see Biome Assets.

Labels and names. The Details panel shows each C++ name with spaces inserted and the b prefix of a boolean dropped (bSolo shows as Solo). Tables give the C++ name. The eighteen BiomeCore fields of a species row use BiomeCore's own names and spellings, carried verbatim, including SelfPrunIngExtentsMultiplier and the enumerator that shows as Additiive. Descriptions of BiomeCore-defined fields follow BiomeCore's own field descriptions. Advanced in a table marks a field the plugin flags as advanced, one you rarely need to change.

Metadata only. DisplayName and Description are labels for people. DisplayName appears in the Output Log lines of sector builds, and nothing reads Description. Neither changes placement, ground cover or any other behaviour of the biome.


Agentic Biome (UAgenticBiome)

The Details panel orders the categories: Validation (a live issue list, see Biome Assets), Identity, Species, Ground cover, Landscape, Provenance.

Identity

PropertyTypeDefaultMeaning
DisplayNameFTextemptyHuman-readable label. Metadata only: it appears in the Output Log lines of sector builds and nothing else reads it.
DescriptionFText (multi-line)emptyFree-text note for the people who open the asset, shown as metadata. Nothing reads it.
DefinitionFAgenticBiomeDefinitionsee DefinitionName, map colour and priority. Copied onto each region built from this biome as its default definition. It is the only place the biome's colour lives.

Species

PropertyTypeDefaultMeaning
SpeciesTArray<FAgenticSpeciesRow>emptyOffline (placed) species: trees, rocks, shrubs and props. Written inline onto each region's LocalAssets. Each element is one species row; the array element title is the row's SpeciesId.

Ground cover

PropertyTypeDefaultMeaning
RuntimeAssetEntriesTArray<FAgenticRuntimeAssetEntry>emptyThe list of GPU runtime ground-cover templates (RT_*) the biome uses, each with a per-backend mask. This is the list a build reads. Element title is Asset. See Runtime asset entry.
RuntimeAssetsTArray<TSoftObjectPtr<UObject>>emptyLegacy list, shown under Advanced. A build never reads it. When the asset loads with RuntimeAssetEntries empty, every non-empty element here is moved into RuntimeAssetEntries with both backends ticked, and this array is cleared. Use RuntimeAssetEntries.

Landscape

PropertyTypeDefaultMeaning
LandscapeLayerNameFNameNoneName of the Landscape paint layer this biome follows. Used where masks are baked from Landscape weightmaps and by the paint-to-biome-map tool. Read from Landscape weightmaps only: on MeshTerrain the weight layers cannot be read by this path. A biome with None here is skipped by those paths.

Provenance

PropertyTypeDefaultMeaning
Revisionint320Read-only in Details. Increases by one on every property edit of the asset, including edits to Description. A region stores the value it was built from as SpawnedFromRevision. It is a label, not the staleness test: a region is stale when the hash of the rows the biome emits, or of its runtime entries, differs from the hash stored when the region was built.

Definition (FAgenticBiomeDefinition)

PropertyTypeDefaultMeaning
BiomeNameFNameNoneThe biome's identity. The Terraformer's palette check warns when two palette biomes share a name.
BiomeColorFLinearColorwhite (1, 1, 1)The colour this biome claims in a biome map. Alpha is hidden and not used. It must not be black, which a map reads as "no biome", and it must differ from every other palette colour by more than the Terraformer's Biome Color Tolerance (default 0.01) in at least one of R, G or B.
BiomePriorityint320Higher wins where two biomes claim the same ground. Note the opposite polarity of a generator's GeneratorPriority.

Runtime asset entry (FAgenticRuntimeAssetEntry)

PropertyTypeDefaultMeaning
AssetTSoftObjectPtr<UObject>noneA runtime ground-cover template (an RT_* asset). A template that fails to load is skipped with a warning in the log.
Backendsint32 bitmask3 (both)Which terrain backends use this entry. The Details checkboxes are Landscape (value 1) and Mesh Terrain (value 2). With neither ticked the entry is never carried to a region.

Species row (FAgenticSpeciesRow)

A row has four fields of its own plus the eighteen BiomeCore fields of its base struct. Only the BiomeCore fields reach BiomeCore; the four authoring fields stay on the biome asset.

The Details panel gives each row a header: the Enabled checkbox, the SpeciesId (or the mesh name when the id is empty), the mesh, the weight, the generator with its sub-type, a backend readout such as [L|M], and SOLO or ISO when set. The body is grouped as Placement, Filters, Mesh rendering, Backends, Runtime scatter, Children & assemblies, and Debug. Enabled appears only in the header.

Authoring fields

PropertyTypeDefaultMeaning
SpeciesIdFNameNoneStable key for the row. Tools address a row by it, and an upsert replaces the row with the same id. Required, and unique within the biome.
bSoloboolfalseAuthoring solo. When any enabled row in the biome has it set, only soloed enabled rows are emitted. Details label: "Solo (authoring) - only soloed rows are emitted". A soloed row that is itself disabled does not trigger solo mode.
Backendsint32 bitmask3 (both)Which terrain backends this row serves: Landscape (1), Mesh Terrain (2). A row that excludes the resolved backend is not emitted. With neither ticked the row is never emitted.
BackendOverridesTMap<EAgenticTerrainBackend, FAgenticBackendOverride>emptySparse per-backend replacement of Generator and ChildAssets. Advanced. See Backend override.

BiomeCore fields

PropertyTypeDefaultMeaning
EnabledbooltrueWhether the row is used. An unticked row is dropped before BiomeCore sees it.
AssetTypeFNameNoneLabel identifying the asset type. Shipped rows use Tree, Rock and Clutter. Advanced.
Weightdouble1.0Distribution weight among the rows that share a generator. Minimum 0. A weight of 0 or less is a validator error.
GeneratorTSoftObjectPtr<UObject>noneThe generator asset whose points this species is placed on. The picker accepts an Agentic Biome Generator asset or a BiomeCore generator Blueprint asset. Required.
GeneratorSubTypeFNameNoneRestricts the species to a subset of the generator's points. A comma-separated list is accepted, which lets one generator serve several species. Sub-types are defined in the generator's graph.
TransformGraphTSoftObjectPtr<UPCGGraphInterface>noneOptional PCG graph that modifies or produces points, for example to scatter secondary points around a tree. When unset, the incoming point is used as is. Advanced.
MeshTSoftObjectPtr<UStaticMesh>noneStatic mesh spawned into an instanced mesh component.
SkeletalMeshTSoftObjectPtr<USkeletalMesh>noneSkeletal mesh to spawn. Advanced.
AssemblyTSoftObjectPtr<UObject>nonePCG Data Asset assembly to spawn. Advanced.
ActorFSoftClassPathnoneActor class to spawn. Class picker limited to Actor. Advanced.
ChildAssetsTSoftObjectPtr<UObject>noneA BiomeCore biome-asset Blueprint asset (the shipped Child_* assets) that spawns further assets on this row's points, recursively.
DebugOptionsFAgenticBiomeDebugOptionssee belowBiomeCore render isolation. Details label: "BiomeCore render isolation - does not change what is emitted".
AssetOptionsFAgenticBiomeAssetOptionssee belowPer-instance transform and pruning policy.
MeshOptionsPresetTSoftObjectPtr<UObject>noneA BiomeCore mesh-options preset Blueprint asset. When set, it replaces all of MeshOptions, and Details hides MeshOptions and shows "MeshOptions is not read: preset '...' replaces all 20 values." Advanced.
MeshOptionsFAgenticBiomeMeshOptionssee belowSettings forwarded onto the spawned instanced mesh component. Ignored when MeshOptionsPreset is set.
AssemblyOptionsFAgenticBiomeAssemblyOptionssee belowOptions for assembly spawns. Advanced.
FilterOptionsFAgenticBiomeFilterOptionssee belowCulls generated points before the asset is placed on them.
RuntimeOptionsFAgenticBiomeRuntimeOptionssee belowOptions for BiomeCore's runtime generation. Advanced.

A row with Mesh, SkeletalMesh, Assembly and Actor all empty has nothing to spawn. The SetSpecies tool refuses such a row ("Row spawns nothing"); the validator does not check for it, and the shipped Tree and Tree_MT rows are examples.


Backend override (FAgenticBackendOverride)

Both fields are optional. An unset field means "use the row's own value". A set field replaces the row's value for that backend and outranks it.

PropertyTypeDefaultMeaning
GeneratorTSoftObjectPtr<UObject>noneGenerator used instead of the row's Generator on this backend.
ChildAssetsTSoftObjectPtr<UObject>noneChild asset used instead of the row's ChildAssets on this backend.

The map key is EAgenticTerrainBackend. A build looks up only the Landscape and MeshTerrain keys.


Filter options (FAgenticBiomeFilterOptions)

Shown in the row's Filters group. The first four fields are BiomeCore's own; the other six are sample-tier fields.

PropertyTypeDefaultMeaning
DensityMindouble0.0Reject points whose density is below this. Range 0 to 1.
DensityMaxdouble1.0Reject points whose density is above this. Range 0 to 1.
HeightMindouble (cm)-100000.0World-Z floor in centimetres.
HeightMaxdouble (cm)100000.0World-Z ceiling in centimetres.
FlowMindouble0.0Reject points whose flow (drainage accumulation) is below this. Range 0 to 1. Landscape only.
FlowMaxdouble1.0Reject points whose flow is above this. Range 0 to 1. Landscape only.
SunExposureMindouble0.0Reject points whose sun exposure is below this. Range 0 to 1. Landscape only.
SunExposureMaxdouble1.0Reject points whose sun exposure is above this. Range 0 to 1. Landscape only.
WaterDistanceMindouble (cm)0.0Reject points closer to water than this. No water-distance producer ships, so it does not change placement.
WaterDistanceMaxdouble (cm)100000.0Reject points further from water than this. No water-distance producer ships, so it does not change placement.

Backend notes for the six sample-tier fields:

  • On Landscape, flow and sun exposure are read from two textures that ship with the plugin (T_AT_Flow_Terraformer and T_AT_SunExposure_Terraformer), installed through the filter chain AT_Filters_Inst. They were baked for the terrain of the showcase levels.
  • On MeshTerrain there is no flow or sun-exposure source. The validator reports SampleFilterOnMeshTerrain for any of the six fields set away from its default on a row that serves MeshTerrain.
  • The filter chain installs no water-distance filter, so WaterDistanceMin and WaterDistanceMax have no effect on either backend. The validator still checks them on MeshTerrain rows.

Asset options (FAgenticBiomeAssetOptions)

Shown in the row's Placement group.

PropertyTypeDefaultMeaning
OverlapWithChildrenboolfalseAllow overlapping with child assets. Advanced.
ForceAssetScaleboolfalseIgnore the scale set by the transform graph. Advanced.
ExtentsMultiplierFVector(1, 1, 1)Scales the asset's bounds. Advanced.
BoundsOffsetFVector (cm)(0, 0, 0)Offset applied to the bounds computed from the asset. Advanced.
TranslationFVector(0, 0, 0)Position offset applied over the generator point's position.
RotationFRotator(0, 0, 0)Rotation offset applied over the generator point's rotation.
ScaleFVector(1, 1, 1)Scale factor applied over the generator point's scale.
OrientUpwarddouble0.0Range 0 to 1. 0 keeps the surface normal, 1 forces world up; values between blend from the generator point's normal to world Z up.
SelfPruneboolfalseRemove overlapping points of this asset. The checkbox sits inline with the next field.
SelfPrunIngExtentsMultiplierdouble1.0Scale applied to extents to change self-pruning behaviour. Shown only while SelfPrune is on. The capital I in the name is BiomeCore's spelling and is the real property name.

Mesh options (FAgenticBiomeMeshOptions)

Shown in the row's Mesh rendering group. Forwarded onto the spawned instanced mesh component. Ignored entirely when the row sets MeshOptionsPreset.

PropertyTypeDefaultMeaning
MaterialTSoftObjectPtr<UMaterialInterface>noneMaterial override for the mesh. Advanced.
AllowCollisionboolfalseBiomeCore describes it as "Use Default Mesh Collision settings".
VisiblebooltrueWhether the mesh component is visible. Advanced.
CastShadowbooltrueWhether the mesh casts shadows.
CastHiddenShadowboolfalseWhether the mesh casts shadows when hidden. Advanced.
CastDynamicShadowbooltrueWhether the mesh casts shadows in the case of non-precomputed shadowing. Advanced.
AffectDistanceFieldLightingbooltrueWhether the mesh affects distance-field lighting methods. Only used when CastShadow is true. Advanced.
AffectDynamicIndirectLightingbooltrueWhether the mesh influences indirect lighting. Advanced.
VisibleInRayTracingbooltrueWhether the mesh is visible in ray-traced reflections and shadows. Advanced.
DetailModeint320Required detail level of the mesh. Advanced.
StartCullDistancedouble (cm)0.0Distance from the camera at which each instance starts to fade out.
EndCullDistancedouble (cm)0.0Distance from the camera at which each instance has completely faded out.
EvaluateWorldPositionOffsetbooltrueWhether to evaluate world position offset. The checkbox sits inline with the next field. Advanced.
WorldPositionOffsetDisableDistancedouble (cm)0.0Distance at which world position offset is disabled for an instance. 0 means never disable. Editable only while EvaluateWorldPositionOffset is on. Advanced.
IncludeInHLODboolfalseInclude the mesh in HLOD. The checkbox sits inline with the next field. Advanced.
HLODLayerTSoftObjectPtr<UHLODLayer>noneHLOD layer the mesh is assigned to. Shown only while IncludeInHLOD is on. Advanced.
CanEverAffectNavigationbooltrueWhether the mesh can influence navigation. Advanced.
RasterizeAsFilledConvexVolumeboolfalseWhether navigation geometry from the mesh is converted into a filled vertical convex volume. Advanced.
IsSpatiallyLoadedbooltrueWhether the mesh is spawned on an actor that is spatially loaded in a partitioned world. Advanced.
ComponentTagsFStringemptyComma-separated values applied as additional component tags. A single string, not an array. Advanced.

Runtime options (FAgenticBiomeRuntimeOptions)

Shown in the row's Runtime scatter group; the struct is Advanced on the row. These are BiomeCore's runtime-generation options for a root row. The Details panel notes that they are inert on an offline row and that the runtime tier is fed by the biome's RuntimeAssetEntries list. An enabled row whose GenerationMethod is not None still makes the biome count as having runtime cover (for the validator's EmptyBiome check and the Terraformer's palette check).

PropertyTypeDefaultMeaning
GenerationMethodEAgenticGenerationMethodNoneNone, AutoResolveRuntimeAssembly, RuntimeAssembly or OutputPoints. The names are BiomeCore's. The shipped biomes use RuntimeAssembly together with a RuntimeAssembly asset.
RuntimeAssemblyTSoftObjectPtr<UObject>noneThe assembly used by runtime generation. The shipped biomes point at the L_*MicroScattering_PCG assets under Sample/PCGAssemblies.
MeshSamplingRadiusdouble5.0Asset mesh sampling parameter for runtime generation.
InheritAssetScaleboolfalseInherit the asset's scale. BiomeCore gives no further description.
ScaleMultiplierdouble1.0Scales the sampled mesh points.
NormalOffsetdouble1.0BiomeCore describes it as removing sampled mesh points based on normals.
ZMindouble (cm)0.0Removes sampled mesh points based on height.
ZMaxdouble (cm)500.0Removes sampled mesh points based on height.
InfluenceTypeEAgenticInfluenceTypeNoneAsset influence behaviour at runtime: None, Additive (shown as Additiive, BiomeCore's spelling) or Subtractive.
InfluenceRadiusdouble (cm)100.0Asset influence radius at runtime.
TagsFStringemptyComma-separated tags. A single string, not an array.

Debug options (FAgenticBiomeDebugOptions)

PropertyTypeDefaultMeaning
IsolateboolfalseRender only this row, hiding every other species in the biome. This is BiomeCore's per-row isolation and does not change which rows are emitted. For authoring, use the row's bSolo, which filters the list before BiomeCore sees it.
ShowBoundsboolfalseDisplay the asset's bounds for debugging. Advanced.

Assembly options (FAgenticBiomeAssemblyOptions)

PropertyTypeDefaultMeaning
AllowCollisionboolfalseWhether collisions are allowed or forced off on all assembly inner points.

Generator asset (UAgenticBiomeGenerator)

An Agentic Biome Generator is the asset a species row's Generator points at. It is a UPrimaryDataAsset with one property, Generator (FAgenticGeneratorDefinition), and it is read by BiomeCore the same way as BiomeCore's own generator Blueprint asset. The shipped generators are listed in Biome Assets.

PropertyTypeDefaultMeaning
GeneratorTypeFNameNoneOptional generator name. Shipped generators use it as a family label such as Shared_Trees.
GeneratorGroupsFNameNoneComma-separated list of groups that constrain priority-based difference between generators.
GeneratorPriorityint320Priority over other generators. Smaller number means higher priority, the opposite of BiomePriority. BiomeCore's own authored range is -1 to 1; the validator reports a value outside it.
GeneratorAllowOverlapboolfalseBypass priority-based difference with overlapping points from other generators.
GeneratorGraphTSoftObjectPtr<UPCGGraphInterface>noneThe PCG graph that generates all root points onto which the rows referencing this generator are assigned.
GeneratorSpatialNoiseSettingsTSoftObjectPtr<UPCGSettingsInterface>noneOptional spatial noise that controls the weighted distribution of assets. Point it at a saved spatial-noise settings asset.

Enums

EnumValuesUsed by
EAgenticBackendMaskLandscape = 1, MeshTerrain = 2 (bit flags; 3 is both)Backends on a species row and on a runtime asset entry
EAgenticTerrainBackendAuto, Landscape, MeshTerrainKey of BackendOverrides; the Terraformer's Terrain Backend
EAgenticGenerationMethodNone, AutoResolveRuntimeAssembly, RuntimeAssembly, OutputPointsGenerationMethod
EAgenticInfluenceTypeNone, Additive (displayed Additiive), SubtractiveInfluenceType

Continue with the authoring guide, placement, or support.