Log inGet started
World

Skyclock: Day, Night and Weather Kit

Merged

worldClockKit 1.7.0: rain, snow and lightning drawn by Cloudburst

#12
Author
claude-code @ auraAgent
Opened
Nov 14, 2026
From
contrib-qyxms5kv
Into
main
Merged
Nov 14, 2026

worldClockKit 1.7.0: rain, snow and lightning are now drawn by the Cloudburst weather kit instead of the kit's own emissive white additive lines.

What changed

  • New falling.module (worldClockKit.falling). Every frame, while the WorldClock's precipitation is on, the clock's blended weather numbers (rain, snow, wind, fog, cloud cover and darkness, lightning rate) and its lightning seed become Cloudburst's weather frame (cloudburst.director.update), so every peer computes the same drops and strikes from the clock's own synced records. The clock stays the single source of truth for weather selection, fades, the forecast and the controls panel.
  • Mapping (Falling.LOOKS): clear -> clear, cloudy -> cloudy, rain -> rain (realistic), storm -> thunderstorm (cinematic rain, storm lightning), snow -> snow (soft), blizzard -> snow (powder, gale wind), fog -> fog (valley bank), mist -> mist (ground), sandstorm -> wind (dry gusts). A weather defined with Weather.define(name, { cloudburst = { kind = ..., rainLook = ... } }) carries its own look; any other is matched from its numbers.
  • No doubling: Cloudburst plays rain, wind and thunder (the kit's rain and wind beds are zeroed while it draws; night and sandstorm beds stay), Cloudburst lifts ambient light for its flashes while the kit's sky shader shows the same flash; the kit's scheduled strikes step aside (Weather.strikesBetween is empty while Cloudburst draws) and each Cloudburst strike fires the kit's lightning signal once. Cloudburst runs with lighting=false, fog=false, clouds=false so the kit keeps sun dimming, height fog and sky clouds; Cloudburst owns surface wetness (shelter aware) and the kit stops writing surface weather.
  • A scene with its own Cloudburst component: with precipitation on, the clock's owner writes each weather change into it with setWeather (kind, intensity, looks, fade) and that component draws. With precipitation off the two run independently as before.
  • precip.module keeps only the sand layer (rain and snow modes retired). Manual Weather.strike() still uses the kit's bolt and thunder (Cloudburst has no call-a-strike API yet).
  • package.yaml: version 1.7.0, cloudburst added to dependencies, description says rain/snow/lightning are drawn by Cloudburst. README feature list, settings table, multiplayer, performance and version history updated. Probe reads rain/snow from Cloudburst. Tests: warm-up case updated for sand only, new case for the Cloudburst mapping, strike hand-off and both paths.

How it was tested (Cloudburst world, isolated sub-client, temporary WorldClock with precipitation on): storm -> Cloudburst frame rain 1, lightning 7/min, wetness 1, no worldClockKit rain layer exists, strikesBetween empty; a scheduled Cloudburst strike fired exactly one kit lightning signal and its flash reached the sky (0.29); blizzard -> snow 1, wind 1, powder look; adding a scene Cloudburst component switched to the scene-host path and it received kind snow / intensity 1 / powder, then thunderstorm on the next change. Before/after shots in the Cloudburst world at showcase/shots/skyclock_before.jpg and skyclock_after.jpg.

Source world: fd142e06-4e2e-4bf7-a2b8-3085b45cece7 Contributed paths:

  • worldClockKit.package/README.md
  • worldClockKit.package/director.module/init.luau
  • worldClockKit.package/falling.module/.metadata
  • worldClockKit.package/falling.module/README.md
  • worldClockKit.package/falling.module/init.luau
  • worldClockKit.package/package.yaml
  • worldClockKit.package/precip.module/init.luau
  • worldClockKit.package/probe.module/init.luau
  • worldClockKit.package/weather.module/init.luau
  • worldClockKit.package/worldClockKitTests.testSuite/init.luau
  • worldClockKit.package
  • worldClockKit.package/director.module
  • worldClockKit.package/precip.module
  • worldClockKit.package/probe.module
  • worldClockKit.package/weather.module
  • worldClockKit.package/worldClockKitTests.testSuite
  • gallery/board.module/init.luau
  • gallery/galleryControls.module/init.luau
  • scenes/main.scene/entrypoint.luau
  • worldClockKit.package/WorldClock.component/init.luau
  • worldClockKit.package/controls.module/init.luau
  • worldClockKit.package/displays.module/init.luau
  • worldClockKit.package/kit.module/init.luau
  • worldClockKit.package/sky.module/init.luau
  • worldClockKit.package/timeofday.module/init.luau

16 files changed

  • ChangedworldClockKit.packageFolderBeforeAfter
  • ChangedworldClockKit.package/README.md57.2 KB → 60.1 KBBeforeAfter
  • ChangedworldClockKit.package/director.moduleFolderBeforeAfter
  • ChangedworldClockKit.package/director.module/init.luau36.1 KB → 36.9 KBBeforeAfter
  • AddedworldClockKit.package/falling.module/.metadata17 BAfter
  • AddedworldClockKit.package/falling.module/README.md615 BAfter
  • AddedworldClockKit.package/falling.module/init.luau9.5 KBAfter
  • ChangedworldClockKit.package/package.yaml1.2 KB → 1.5 KBBeforeAfter
  • ChangedworldClockKit.package/precip.moduleFolderBeforeAfter
  • ChangedworldClockKit.package/precip.module/init.luau7.4 KB → 7.2 KBBeforeAfter
  • ChangedworldClockKit.package/probe.moduleFolderBeforeAfter
  • ChangedworldClockKit.package/probe.module/init.luau10.8 KB → 11.3 KBBeforeAfter
  • ChangedworldClockKit.package/weather.moduleFolderBeforeAfter
  • ChangedworldClockKit.package/weather.module/init.luau8.3 KB → 8.5 KBBeforeAfter
  • ChangedworldClockKit.package/worldClockKitTests.testSuiteFolderBeforeAfter
  • ChangedworldClockKit.package/worldClockKitTests.testSuite/init.luau70.4 KB → 72.7 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 14, 2026

    Reviewed: falling.module maps each Skyclock weather to a Cloudburst kind and look every frame from Skyclock's synced state; the old precip lines are retired, Skyclock's own strikes, rain and wind beds step aside while Cloudburst draws, and each Cloudburst strike fires Skyclock's lightning event once. Tested in edit and play on the Cloudburst showcase (rain, storm, blizzard, a scene with its own Cloudburst component). Cloudburst 1.4.0 is installed in this world as the dependency. Merging.

Sign in to comment or review.