Sky, time and weather

Set your world’s light: six skies, time of day, day / night cycle, physical sky dome, HDRI skies, fog, sun, ambient light, rain and snow.

The Look section of the Map step sets the sky and light. Everything lives in the document’s rules object: a sky preset, an hour that places the sun, a fog density, light intensities, and if you want a physical dome, an HDRI sky, a day / night cycle or weather.

Day

Sunset

Night

Overcast

Neon

The six skies

A sky preset (skyPreset) sets at once the sky and fog colour, the sun colour and intensity, the ambient light, the ground tint picked up by the hemisphere light, and the amount of daylight. Picking a sky clears custom colours.

skyPreset	Name	Sky	Sun	Intensity	Ambient
`day`	Day	`#bfe3ff`	`#fff4e0`	1.6	0.9
`sunset`	Sunset	`#ffb08a`	`#ffb070`	1.7	0.7
`night`	Night	`#0b1226`	`#8fb2ff`	0.5	0.25
`overcast`	Overcast	`#cfd6dd`	`#ffffff`	0.9	1.1
`void`	Void	`#0b0c10`	`#ffffff`	1.4	0.5
`neon`	Neon	`#12061f`	`#ff5cf0`	1.2	0.6

Custom colour

The Sky colour picker writes the same colour to sky and fog, which keeps a seamless horizon.

Time of day and day / night cycle

The Hour slider (hour, 0 to 24 in half-hour steps) places the sun: it rises around 6, peaks at noon and sets around 18. When it goes below the horizon, night falls whatever the preset: light drops and the sky darkens (except for the Night, Neon and Void skies, already dark). With no hour set, Sunset sits at 18:30, Night at midnight, the others at 11.

Day cycle (dayCycleMinutes) runs the clock during play: the value is how many real minutes a full 24-hour day lasts. 0 freezes the hour. The cycle only runs in game (Test step and players).

rules.jsonJSON

{
  "skyPreset": "day",
  "hour": 7,
  "dayCycleMinutes": 10,
  "fogDensity": 0.6
}

A dawn that turns into a full day in ten minutes of play.

Sky dome and HDRI skies

The sky dome box (skyDome) replaces the flat background with a physical sky (three.js Sky) that follows the real sun position. It only shows with the Realistic and Low poly styles, and hides when the sun goes below the horizon to let the night sky through.

No bloom under the dome

The dome outputs light values far above 1: any bloom threshold low enough to make emissive materials glow would also flood the sky with white haze. Under the dome, bloom is therefore skipped. The neon and night moods use a flat sky and keep their glow.

The HDRI sky menu offers the 28 HDRI skies of the library (Poly Haven, CC0, 1k). The equirectangular image serves both as the background, slightly blurred, and as the lighting and reflection environment. An HDRI wins over the sky dome. The hdri field holds the URL of the .hdr file.

Light and fog

sunnumber

Sun intensity, 0 to 3 in the panel. Defaults to the preset’s.

ambientnumber

Ambient (hemisphere) light, 0 to 2. Defaults to the preset’s.

fogDensitynumberDefault 0.5

Fog density, 0 to 1. The higher it is, the closer the fog starts.

skystring

Sky colour, overrides the preset’s.

fogstring

Fog colour.

hournumber

Time of day, 0 to 24.

dayCycleMinutesnumberDefault 0

Real minutes for a full day; 0 = frozen.

skyDomebooleanDefault false

Physical sky (Realistic and Low poly styles).

hdristring

URL of an equirectangular HDRI.

weather'none' | 'rain' | 'snow'Default 'none'

Precipitation.

With the Realistic and Low poly styles, the world also gets an environment light that follows daylight: metallic and glossy surfaces keep believable reflections even without an HDRI.

Weather

The Weather menu adds rain or snow: a particle cloud that follows the camera, so precipitation always surrounds the player at little cost.

weather	Look
`none`	Dry sky (default).
`rain`	Fast bluish drops.
`snow`	Slow, larger white flakes.

The six skies#

Custom colour#

Time of day and day / night cycle#

Sky dome and HDRI skies#

Light and fog#

Weather#

See also#