sun that moves across the sky as day turns to night

A day-night cycle is a SCRIPT PATTERN over the LightComponent. Drive a tick or timer handler that patches a directional light's rotation, intensity, and color from a time-of-day phase in state. LightComponent.modulation gives built-in flicker, pulse, strobe, and disco without a script. There is no per-field AI setter for the world sky time-of-day.

day night cycle that changes the lighting over time

A day-night cycle is a SCRIPT PATTERN over the LightComponent. Drive a tick or timer handler that patches a directional light's rotation, intensity, and color from a time-of-day phase in state. LightComponent.modulation gives built-in flicker, pulse, strobe, and disco without a script. There is no per-field AI setter for the world sky time-of-day.

make a light flicker or pulse

A day-night cycle is a SCRIPT PATTERN over the LightComponent. Drive a tick or timer handler that patches a directional light's rotation, intensity, and color from a time-of-day phase in state. LightComponent.modulation gives built-in flicker, pulse, strobe, and disco without a script. There is no per-field AI setter for the world sky time-of-day.

dim and tint the lighting on a timed day-night schedule

A day-night cycle is a SCRIPT PATTERN over the LightComponent. Drive a tick or timer handler that patches a directional light's rotation, intensity, and color from a time-of-day phase in state. LightComponent.modulation gives built-in flicker, pulse, strobe, and disco without a script. There is no per-field AI setter for the world sky time-of-day.

Day night cycle and moving sun by script

The recipe

Author with project_apply_script_semantic_patch using the ai_safe op pack. The sun is an entity with a directional LightComponent (mode:"directional").

Advance a clock: keep a timeOfDay phase (0 to 1) in durable state. Drive it from addTickHandler scaled by ctx.delta, or from a TimerComponent plus addTimerHandler for coarse steps. incrementNumericState { "field":"timeOfDay", "by": <delta / dayLengthSeconds> } and wrap at 1.
Move the sun: in the body (whole-body GessaScript via replaceScriptFromGessaScript), map timeOfDay to a sun angle and ctx.entity.patchComponent the light's rotation (a directional light's direction follows its transform). This is the moving-sun arc.
Change the look: patch intensity down toward night and back up toward day, and patch color warm at dawn and dusk, cool at noon, dark at night. Turn castShadow on for a hard midday sun if desired.
No script needed for oscillating light: set LightComponent.modulation (mode one of none, strobe, pulse, flicker, disco, plus rateHz and depth) for a torch flicker or a club strobe directly on the component.
Reuse the same phase to drive ambient fill: patch a second ambient-mode light's intensity so shadows do not go pure black at night.

Pitfalls

Scale the phase step by ctx.delta; a fixed per-tick step makes day length depend on frame rate.
Store timeOfDay in durable state so a reload resumes at the same time and all clients read one clock.
There is NO per-field AI tool to set the world sky's built-in time-of-day (WorldAuthoredEnvState.simTimeSeconds/timeOfDayRate); animate an authored LightComponent yourself instead of expecting a sky-clock setter.
Keep intensity at or above a small floor; a directional light at 0 with no ambient fill renders a black scene.
Prefer LightComponent.modulation over a per-tick script for pure flicker or strobe; it is cheaper and deterministic.

Verify

simulation_run (qa.run.start) to watch a full cycle move the sun and shift intensity and color from day to night.
project_get_graph_snapshot to confirm the tick or timer handler and the directional LightComponent are present.

The recipe

Pitfalls

Verify

On this page