Atmosphere

Supported Object types: 2d, 3d. Attach this component where needed. An Object has at most one instance of this component.

Use Object components to understand definitions and instance overrides.

Atmosphere contains scene presentation and clock configuration. Empty nested records do not mean that every clock or renderer setting is zero: preset, scene, and runtime defaults supply the remaining values.

Defaults below are normalized factory values from the component schema. Object presets, dimension, project units, and Scene overrides can supply different starting values. “Not stored” means the path is optional or runtime-derived. Read the property description to interpret it. Blank resource references assign no resource.

Writable means exposed for property writes through Logic. A No entry can still be editable in the Object Editor; runtime-only values cannot be authored. World-space lengths use metres, screen-space lengths use pixels, and rotations use degrees unless stated otherwise. The current loader refuses pixel-era projects. Use Units and Coordinates when comparing values.

Property and path	Type	Factory default	Behavior	Writable
Enabled (enabled)	boolean	true	Whether this Atmosphere contributes its authored scene settings.	Yes
Dimension (dimension)	text	“2d”	Dimension of the Atmosphere: 2d or 3d. Available visual settings depend on dimension.	No
Preset (preset)	text	“”	Atmosphere preset resource or name. Blank supplies no named preset.	Yes
Shader (shader)	thing:shader	“”	Shader resource used by this Atmosphere. Requires a compatible shader.	Yes
Day/Night Cycle (dayNight.enabled)	boolean	Not stored; see behavior	Enables the game clock and day/night presentation.	Yes
Full Day Minutes (dayNight.dayMinutes)	number	Not stored; see behavior	Length of a complete game day in real-time minutes. Clock pause policies affect elapsed advancement.	Yes
Starting Hour (dayNight.startHour)	number	Not stored; see behavior	Initial game-clock hour, using the 24-hour clock.	Yes
Starting Minute (dayNight.startMinute)	number	Not stored; see behavior	Initial minute within the game-clock hour.	Yes
Dawn Start (dayNight.dawnStart)	number	Not stored; see behavior	Hour at which dawn begins.	No
Day Start (dayNight.dayStart)	number	Not stored; see behavior	Hour at which day begins.	No
Dusk Start (dayNight.duskStart)	number	Not stored; see behavior	Hour at which dusk begins.	No
Night Start (dayNight.nightStart)	number	Not stored; see behavior	Hour at which night begins.	No
Dawn Color (dayNight.dawnColor)	color	Not stored; see behavior	Tint used for the dawn phase.	No
Dawn Strength (dayNight.dawnStrength)	number	Not stored; see behavior	Blend strength of the dawn tint.	No
Dusk Color (dayNight.duskColor)	color	Not stored; see behavior	Tint used for the dusk phase.	No
Dusk Strength (dayNight.duskStrength)	number	Not stored; see behavior	Blend strength of the dusk tint.	No
Night Color (dayNight.nightColor)	color	Not stored; see behavior	Tint used for the night phase.	No
Night Strength (dayNight.nightStrength)	number	Not stored; see behavior	Blend strength of the night tint.	No
Affect 3D (dayNight.affect3d)	boolean	Not stored; see behavior	Applies day/night presentation to 3D scene lighting.	No
Pause in Cutscenes (dayNight.pauseInCutscenes)	boolean	Not stored; see behavior	Holds the clock while a cutscene is active.	No
Pause in Battles (dayNight.pauseInBattles)	boolean	Not stored; see behavior	Holds the clock while a battle is active.	No
Pause in Menus (dayNight.pauseInMenus)	boolean	Not stored; see behavior	Holds the clock while a menu is active.	No
Pause in Dialogue (dayNight.pauseInDialogue)	boolean	Not stored; see behavior	Holds the clock while dialogue is active.	No
Sky Color (visual3d.sky)	color	Not stored; see behavior	Sky style or configuration selected for the 3D scene.	No
Sky Mode (visual3d.atmosphere.mode)	text	Not stored; see behavior	3D atmosphere rendering mode.	No
Sky Haze (visual3d.atmosphere.haze)	number	Not stored; see behavior	Haze strength in the 3D atmosphere.	No
Sky Night Amount (visual3d.atmosphere.night)	number	Not stored; see behavior	Night presentation strength in the 3D atmosphere.	No
Stars (visual3d.atmosphere.stars)	boolean	Not stored; see behavior	Star visibility or strength in the 3D atmosphere.	No
Sun Intensity (visual3d.sun.intensity)	number	Not stored; see behavior	Sun light intensity multiplier.	No
Sun Direction X (visual3d.sun.dirX)	number	Not stored; see behavior	X component of the sun direction vector. This is a direction rather than a position.	No
Sun Direction Y (visual3d.sun.dirY)	number	Not stored; see behavior	Y component of the sun direction vector. This is a direction rather than a position.	No
Sun Direction Z (visual3d.sun.dirZ)	number	Not stored; see behavior	Z component of the sun direction vector. This is a direction rather than a position.	No
Sun Color (visual3d.sun.color)	color	Not stored; see behavior	Sun light color.	No
Ambient Intensity (visual3d.ambient.intensity)	number	Not stored; see behavior	Ambient light intensity multiplier.	No
Ambient Color (visual3d.ambient.color)	color	Not stored; see behavior	Ambient light color.	No
Fog Enabled (visual3d.fog.enabled)	boolean	Not stored; see behavior	Enables distance fog.	Yes
Fog Color (visual3d.fog.color)	color	Not stored; see behavior	Distance fog color.	No
Fog Near (visual3d.fog.near)	number	Not stored; see behavior	Fog start distance in metres. Keep it below Fog Far.	Yes
Fog Far (visual3d.fog.far)	number	Not stored; see behavior	Fog end distance in metres. Geometry beyond it receives the full distance-fog effect.	Yes