ZOA Terrain

ITerrainBuilder

interface

Pure-C# terrain building. Implementations must be deterministic: the same profile and seed produce a byte-identical heightmap and identical vantage ordering.

• TerrainBuildResult Build(TerrainProfileDefinition profile, Scene targetScene)

TerrainBuilder

class

The shipped builder: multi-octave fbm, ridge shaping, valley carve, plateau insertion and a spawn-clear pass. Edit-time only, and can take seconds on a Huge profile.

TerrainBuildResult

struct

A snapshot of one build. Carries the terrain root, bounds, the cleared spawn position, the vantage candidates, the resolution and world size actually used, and the issues raised.

• GameObject TerrainRoot
• Bounds Bounds
• Vector3 SuggestedPlayerSpawn
• IReadOnlyList<Vector3> VantageCandidates
• IReadOnlyList<TerrainBuildIssue> Issues
• int HeightmapResolution
• float WorldSizeMeters
• bool HasErrors { get; }

IFeatureScatterer

interface

Places features on a built terrain and stamps the anchor components the layout's kinds direct. Deterministic for a given layout and seed.

• FeatureScatterResult Scatter(TerrainBuildResult terrain, TerrainProfileDefinition profile, int seed)

FeatureScatterResult

struct

Per-category placement counts plus non-fatal issues, so the wizard can show a telemetry summary in its issue tray.

• int TotalPlaced
• IReadOnlyDictionary<FeatureKindCategory, int> CountByCategory
• IReadOnlyList<TerrainBuildIssue> Issues
• int CountFor(FeatureKindCategory category)

TerrainBuildIssue

struct

One build-time finding with a severity, a machine-readable code and a message. A warning lets the build proceed; an error aborts and leaves the scene without a terrain root.

• TerrainBuildSeverity Severity
• string Code
• string Message
• static TerrainBuildIssue Info(string code, string message)
• static TerrainBuildIssue Warning(string code, string message)
• static TerrainBuildIssue Error(string code, string message)

TerrainSizePreset

enum

Small (257 / 250m), Medium (513 / 500m), Large (1025 / 1000m), Huge (2049 / 2000m, behind a confirm dialog), Custom.

• static int HeightmapResolution(this TerrainSizePreset preset)
• static int AlphamapResolution(this TerrainSizePreset preset)
• static int DetailResolution(this TerrainSizePreset preset)
• static float WorldSizeMeters(this TerrainSizePreset preset)
• static float EstimatedPeakMemoryMb(this TerrainSizePreset preset)

FeatureKindCategory

enum

What a placement means. Vegetation, Detail, Rock and Structure place geometry; CoverPoint, VantageMarker, AiSpawnZone, LootAnchor and HeroSpawnAnchor stamp markers other systems read.

TimeOfDayPreset

enum

Dawn, Day, Dusk, Night, Storm. Resolve combines a preset with the biome's fog tint and density into an AtmosphericProfile.

• static AtmosphericProfile Resolve(this TimeOfDayPreset preset, Color biomeFogTint, float biomeFogDensity)

AtmosphericProfile

struct

The resolved lighting and fog settings for one time of day, applied by EnvironmentApplier.

• Color SunColor
• float SunIntensity
• Vector3 SunRotationEulers
• Color AmbientLight
• Color FogColor
• float FogDensity
• Color SkyboxTint

EnvironmentApplier

class

Applies an AtmosphericProfile to the directional light and RenderSettings. Pure C#, and skips gracefully when there is no active terrain.

• static void Apply(AtmosphericProfile atmos, Light directionalLight)

VantagePointMarker

component

Metadata-only marker at a peak, plateau or ridge with elevation advantage. The tactical AI evaluator reads these as its candidate set.

• Vector3 Position { get; }
• float Prominence { get; }
• float PlateauRadius { get; }
• bool SniperAuthored { get; }
• void Configure(float prominence, float plateauRadius, bool authored = false)

TerrainSpawnZoneAnchor

component

Marker at a candidate AI, hero or loot spawn. The SceneSeed applier ensure-adds an AiSpawnZone and sizes it from ZoneRadius.

• ZoneRole Role { get; }
• float ZoneRadius { get; }
• string AnchorTag { get; }
• Vector3 Position { get; }
• void Configure(ZoneRole role, float zoneRadius, string anchorTag = null)

ProceduralStructureMarker

component

Identity tag on every structure the factory builds, so later passes locate landmarks by component rather than by name pattern.

• StructurePrefabFactory.StructureKind Kind { get; }
• float FootprintRadius { get; }
• float EstimatedHeight { get; }

DemoSceneGeneratorRunner

class

The headless pipeline: build, scatter, apply the seed, bake NavMesh, save. The wizard's Generate button and the tests call the same method.

• static DemoSceneGeneratorResult Generate(DemoSceneGeneratorContext context)
• static void RunEnhancementPasses(...)

DemoSceneGeneratorContext

class

The request. Wizard steps mutate one and hand the final snapshot to the runner; a test constructs one directly.

• TerrainProfileDefinition Profile
• string SceneName
• string SceneFolder
• SceneSeedDefinition Seed
• int SeedOverride
• bool SkipNavMeshBake
• bool OpenAfter

DemoSceneGeneratorResult

class

Outcome of one generate: the saved scene path and scene, both sub-results, and any cross-cutting issues.

• string ScenePath
• Scene Scene
• TerrainBuildResult TerrainResult
• FeatureScatterResult ScatterResult
• List<TerrainBuildIssue> AdditionalIssues
• bool Succeeded

BundledTerrainProfiles

class

In-memory profiles and biomes used when no authored asset exists at the expected path. AI Encounters, Forest and Desert profiles; forest, desert and mountain biomes.

• static TerrainProfileDefinition BuildAiEncounters()
• static TerrainProfileDefinition BuildForest()
• static TerrainProfileDefinition BuildDesert()
• static TerrainBiomeDefinition BuildForestBiome()
• static TerrainBiomeDefinition BuildDesertBiome()
• static TerrainBiomeDefinition BuildMountainBiome()

TerrainProfileDefinition

asset

The whole terrain configuration in one asset. Assets > Create > ZOA > Terrain > Terrain Profile.

• TerrainSizePreset Size { get; }
• int Seed { get; }
• float RidgePower, ValleyDepth, PeakHeightMeters { get; }
• AnimationCurve HeightFalloff { get; }
• int PlateauCount { get; }
• float PlateauRadius { get; }
• TerrainBiomeDefinition Biome { get; }
• FeatureLayoutDefinition FeatureLayout { get; }
• TimeOfDayPreset TimeOfDay { get; }
• bool PlaceWater { get; }
• float WaterAltitudeNormalised, WeatherIntensity { get; }
• bool ApplyUrpVolume { get; }
• int DesiredVantageMarkers, DesiredCoverNetworks { get; }
• float SpawnClearRadius { get; }
• int ResolveResolution()
• float ResolveWorldSize()

TerrainBiomeDefinition

asset

Ground layers, grass and tree entries keyed by semantic id, plus fog tint and density. Assets > Create > ZOA > Terrain > Terrain Biome.

• GroundLayer[] GroundLayers { get; }
• GrassEntry[] Grass { get; }
• TreeEntry[] Trees { get; }
• Color FogTint { get; }
• float FogDensity { get; }
• struct GroundLayer { string MaterialSemanticId; float MinAltitude; float MaxAltitude; float MinSlopeDegrees; float MaxSlopeDegrees; }

FeatureLayoutDefinition

asset

Composes feature kinds into layers with per-layer density scaling and global caps. Assets > Create > ZOA > Terrain > Feature Layout.

• FeatureLayer[] Layers { get; }
• float GlobalDensityMultiplier { get; }
• int GlobalMaxInstances { get; }
• struct FeatureLayer { FeatureKindDefinition Kind; float DensityScale; string InstanceTag; }

FeatureKindDefinition

asset

One placeable thing: category, prefab, semantic id, altitude and slope bands, density, spacing, caps and jitter. Assets > Create > ZOA > Terrain > Feature Kind.

• FeatureKindCategory Category { get; }
• GameObject Prefab { get; }
• string SemanticId { get; }
• float MinAltitude, MaxAltitude { get; }
• float MinSlopeDegrees, MaxSlopeDegrees { get; }
• float DensityPer100SqMeters { get; }
• float MinSpacing { get; }
• int MaxInstances { get; }
• float YRotationJitter { get; }
• Vector2 ScaleRange { get; }