Component · render

SkyAtmosphere

A physical sky and aerial perspective lit by the scene's directional light. The sun's elevation sets the time of day; without this component the scene uses its Environment gradient. The first entity in ID order wins.

Fields

seaLevel

f32

World altitude of the planet surface (sea level); the sky and fog measure height from here.

default 0m

aerosols

f32

Aerosol (haze, dust) density relative to clear Earth air. Raise it for dusty or humid skies: a whiter horizon, a wider sun glow and stronger aerial perspective.

default 10 – 20

cloudCoverage

f32

Fraction of the sky covered by the lit cloud layer; 0 disables clouds.

default 00 – 1

cloudHeight

f32

Altitude of the cloud layer above sea level.

default 2200m500 – 20000

Usage

Every edit is an undoable command: from the CLI as below, or the same JSON from an agent over MCP. See component.add and property.set.

Add it

ara do component.add -p entity=name:Crate -p component=SkyAtmosphere --why "Add SkyAtmosphere"

Set a field

ara do property.set -p entity=name:Crate -p path=SkyAtmosphere.seaLevel -p value=0 --why "Tune SkyAtmosphere"

In a scene document

{
  "SkyAtmosphere": {
    "seaLevel": 0
  }
}

From C#

/// <summary>Bring in clouds during a weather transition.</summary>
public static void UseSkyAtmosphere(Entity entity, in Tick tick)
{
    ref var component = ref World.Get<SkyAtmosphere>(entity);
    component.CloudCoverage = 0.7f;
}

From C#

Scripts read and write it with Get<SkyAtmosphere>(); see the SkyAtmosphere struct.