Skip to content

Scene mood and time of day

The Lighting pane is where you set the look of the whole scene — the global darkness, the colour grading, what time of day it is, and any zones that should be darker than the rest. Open it at the Build table on a computer: click Lighting at the top right.

This page covers ambient + mood + time-of-day + spatial darkness regions. For atmosphere (god rays, weather, volumetric fog) see Atmosphere and weather.

The Ambient darkness fader (captioned Dark), beside the sky clock under Day and dark, sets the scene-wide darkness floor:

  • 0 — fully bright. Lights add brightness on top, but the world is already lit.
  • 1 — pitch black. Only individual lights illuminate anything.

Most “lit but moody” scenes sit around 0.4–0.7. A torch-only dungeon goes to 0.9+.

Under Vision and light, the Global light switch keeps a scene lit unless it gets properly dark:

  • With Global light on and the scene’s darkness below the threshold, every light shows, whatever darkness range you gave it.
  • Once darkness rises past the threshold, a light with a darkness range shows only while the scene’s darkness is inside that range.

The threshold is 0.5 and has no control of its own at the table. A scene imported from Foundry keeps the threshold it had there.

Use it for scenes that are bright by default but go dark for specific dramatic beats.

The Ambient colour discs tint the shadowed parts of the scene (Custom beside them picks any colour). Cool blue for moonlit, dusty orange for sunset, sickly green for swamp. Combined with Mood below, you get fine control over the overall palette.

Mood is a curated colour grade applied across the whole rendered scene — like a film LUT. Open More at the bottom of the pane (Show) and pick from the swatches in the Scene Mood section:

Mood Feel
Daylight Neutral reference; no grading.
Warm Tavern Amber highlights, soft brown shadows. Firelight feel.
Cold Crypt Steel-blue shadows, drained mids. Stone-vault.
Eldritch Green Sickly green dominant, drained reds.
Moonlight Cool silver-blue, low saturation.
Stormy Slate midtones, desaturated. Cold rain.
Underdark Magenta-violet shadows, mossy green highlights.
Hellscape Crimson highlights, charcoal shadows.

Click a swatch to apply. The Strength slider underneath dials the grade from identity (0) to full (1). Click Clear to remove the mood entirely.

Moods stack on top of everything else — they’re the last thing applied before the picture lands on the canvas. Two scenes with identical lights look completely different under “Daylight” vs “Hellscape”.

Under Day and dark, the sky clock sets the darkness and tint from a simulated sun. It’s the same clock as Map Foundry’s sky:

Control Effect
Light: By the clock / By hand By the clock, the hour sets the darkness and overrides the ambient darkness fader. By hand, the fader sets it; the clock’s centre says so, with Set by the clock to start the clock again.
The sky clock Drag the sun round the ring to set the hour, in quarter hours; the ring is painted with that day’s sky. With the clock focused, the arrow keys move a quarter of an hour, Page Up and Page Down an hour, Home goes to dawn and End to night.
Dawn / Day / Dusk / Night Jump to that time. Pressing one while the light is set by hand starts the clock there.
Season Spring / Summer / Autumn / Winter — affects sun height. Shown while the light is by the clock.
Latitude 90° S to 90° N — affects sun angle. Drag it, or type a value; the reset button puts it back to 45° N. Shown while the light is by the clock.

A scene in summer at 12:00 latitude 45 is bright and neutral; the same scene at winter 18:00 latitude 60 is deep blue and dim. Useful for outdoor maps that span hours of in-game time.

While the light is by the clock, the ambient darkness fader is greyed out (“Darkness follows the time of day while it runs.”) — the derived value wins.

A scene made from a battle map with Create scene is repainted for the hour, not just darkened. The sun moves to where the hour puts it, so shadows swing and lengthen. Dawn comes in cool, evening turns warm and night falls blue. Some doorways light up at dawn and dusk, the same ones the battle map creator lights, and the rest as night falls, even on a map painted by day. Lanterns on posts along the streets show only on maps painted at dawn, dusk or night. Fires, lava and glowing runes burn at every hour.

  • As you drag the hour, your map follows the dial. When you stop, every player sees the light move across their map to that hour over about eight seconds.
  • On a phone or tablet the repainting is lighter (a softer picture, the light moving in steps), and a device that can’t repaint the map keeps its painted light and darkens with the hour; the Lighting pane says so.
  • At the hour the map was painted for, the scene looks exactly like the painting.
  • While the map is relit, your lights light the painting itself. A torch at night warms the stones around it, and walls keep its light on their side. Tokens and tiles take the same light as the ground they stand on, including the glow of the map’s own lamps and fires. By day a light shows little, as it would in sunshine.
  • Set the light By hand to go back to the map as it was painted.

Sometimes you want one part of a scene to be darker than the rest — a shadowy alcove inside a lit room, the cellar trapdoor in a tavern. Darkness regions are polygon overlays you draw on the canvas to override the ambient darkness inside their outline.

  1. In the Lighting pane, find Darkness regions.
  2. Click + Draw a region. Your cursor enters region-draw mode; the pane stays open beside the map.
  3. Left-click on the canvas to place vertices.
  4. Double-click, click the start vertex, or press Enter to finish.
  5. Right-click to undo the last vertex; Escape cancels the in-progress draw.

The new region appears in the pane as a small picture of its shape, with its darkness beside it. Each region has its own:

  • Darkness slider (0..1) — how dark inside the polygon.
  • Tint colour — local ambient tint that overrides the scene-wide one inside the polygon.
  • Delete button.

Regions stack on top of the ambient darkness; the higher value wins inside the polygon, so you can carve a darker zone into a brighter scene. Lights still punch through normally — a torch placed inside a darkness region illuminates it locally just like anywhere else.

A typical “twilit clearing” recipe:

  1. Set the light By the clock, turn the sun to 19:00, summer, latitude 45° N.
  2. Pick Moonlight mood at strength 0.5.
  3. Add a darkness region polygon over the dense thicket on the east side, darkness 0.85.
  4. Place a campfire light in the centre of the clearing.

The result is a bright-ish clearing fading to deep blue around the edges, with a darker thicket the players can’t see into until they approach with a torch.