add a sun and sky with lighting

Light a scene with a directional LightComponent as the sun and an ambient LightComponent for fill; add local mood with LocalEnvironmentVolumeComponent fog and exposure overrides; apply a global renderer look with renderer.visual_profile.apply. Time-of-day is a world-authored EnvState seed advanced server-authoritatively.

fog and mood lighting for the scene

Light a scene with a directional LightComponent as the sun and an ambient LightComponent for fill; add local mood with LocalEnvironmentVolumeComponent fog and exposure overrides; apply a global renderer look with renderer.visual_profile.apply. Time-of-day is a world-authored EnvState seed advanced server-authoritatively.

directional sunlight and ambient fill light

Light a scene with a directional LightComponent as the sun and an ambient LightComponent for fill; add local mood with LocalEnvironmentVolumeComponent fog and exposure overrides; apply a global renderer look with renderer.visual_profile.apply. Time-of-day is a world-authored EnvState seed advanced server-authoritatively.

day night atmosphere and time of day

Light a scene with a directional LightComponent as the sun and an ambient LightComponent for fill; add local mood with LocalEnvironmentVolumeComponent fog and exposure overrides; apply a global renderer look with renderer.visual_profile.apply. Time-of-day is a world-authored EnvState seed advanced server-authoritatively.

Atmosphere sky lighting fog and time of day

The recipe

Sun: attach a directional LightComponent { "type":"LightComponent", "mode":"directional", "color":"#fff2e0", "intensity": 3, "castShadow": true }. mode is one of directional, point, spot, area_rect, area_disc, ambient. Point the sun by rotating the entity's TransformComponent.
Fill: add a second entity with an ambient LightComponent { "type":"LightComponent", "mode":"ambient", "color":"#8090b0", "intensity": 0.4 } so shadows are not pure black.
Effect lights: point/spot lights use distance, decay, angleDeg (1..180 for spot cone), penumbra; flicker/pulse via modulation { "mode":"flicker", "rateHz": 6, "depth": 0.4, "seed": 1 } (modes none, strobe, pulse, flicker, disco).
Mood zones: attach LocalEnvironmentVolumeComponent to a region entity { "type":"LocalEnvironmentVolumeComponent", "enabled": true, "shape":"box", "overrideFog": true, "fogDensity": 0.3, "overrideAmbient": true, "ambientIntensity": 0.6, "overrideExposureCompensation": true, "exposureCompensationBias": -0.5, "priority": 1, "blendDistance": 4 }. It sparse-overrides the global environment inside its bounds and blends to the world default at blendDistance.
Global look: apply a renderer visual profile to the world with world_apply_visual_profile (renderer.visual_profile.apply) for the sky preset, tone mapping, and post look shipped as a profile.
Day-night: the world environment carries an authored EnvState seed (simTimeSeconds in [0,86400), timeOfDayRate game-hours per real second; 0 is static). A moving sun is that rate plus, if you want scripted control, a TimerComponent firing a handler that patches the sun LightComponent.

Pitfalls

Every color is #rrggbb/#rrggbbaa; intensity, distance, decay are >= 0. angleDeg is 1..180.
Only ENABLED LocalEnvironmentVolumeComponents apply, and equal-priority overlaps resolve deterministically by entity id (warned). Give the dominant zone a higher priority.
LocalEnvironmentVolumeComponent only overrides the fields whose override* flag is true; setting fogDensity without overrideFog: true does nothing.
There is no SkyComponent atomic; global sky is world environment plus a visual profile, not a component you attach to an entity.

Verify

engine_get_component_schema on LightComponent and LocalEnvironmentVolumeComponent.
qa_capture_renderer_viewport to confirm the sun, shadows, and fog read.

The recipe

Pitfalls

Verify

On this page