Log inGet started
World

Cloudburst: Rain, Snow, Storms and Fog for Your Game

Merged

Publish weather as named values (weather.rain/snow/wetness/wind) so other kits can react without requiring Cloudburst

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

What: every frame the Cloudburst director writes four named values on the weather entity: weather.rain (0-1, sleet and hail counted as rain where they land), weather.snow (0-1), weather.wetness (0-1, the ground's wetness Atmos already computes) and weather.wind (vector, m/s, gust included). Adds D.publish(entityId, frame, windVec), passes the entity id through the component's host() table, documents it under 'For other kits' in the README, and states version 1.3.1.

Why: a kit that reacts to rain (a water kit ringing lakes and puddles, foliage swaying to wind, a splashing footstep) today has to require cloudburst.weather, which makes it depend on Cloudburst. Named values are an engine-level, dependency-free channel: the reader scans values.entities() for weather.rain. Tidewater (a water kit) reads exactly these, so Cloudburst's rain rings Tidewater's lakes and puddles in any world that has both, and neither kit requires the other. Nothing is replicated: every peer already runs the same weather from the shared clock.

Tested: in play with Cloudburst { preset = steady_rain }, values.get(weatherEntity, 'weather.rain') = 0.52, weather.wetness = 0.60, weather.wind = (3.57, 0, 3.00); Tidewater's weatherLink picked them up. Cost: four values.set calls per frame on one entity.

Source world: 34465908-dbbb-4f09-b22a-ed8306dea455 Contributed paths:

  • cloudburst.package/Cloudburst.component/init.luau
  • cloudburst.package/README.md
  • cloudburst.package/director.module/init.luau
  • cloudburst.package/package.yaml
  • cloudburst.package
  • cloudburst.package/Cloudburst.component
  • cloudburst.package/director.module
  • cloudburst.package/FogBank.component/init.luau
  • cloudburst.package/weather.module/init.luau
  • scenes/main.scene/authoring/state.json
  • scenes/main.scene/build.luau
  • scenes/main.scene/scene.json
  • showcase/weatherLab.module/init.luau

9 files changed

  • Changedcloudburst.packageFolderBeforeAfter
  • Changedcloudburst.package/Cloudburst.componentFolderBeforeAfter
  • Changedcloudburst.package/Cloudburst.component/init.luau8.6 KB → 8.7 KBBeforeAfter
  • Changedcloudburst.package/README.md5.5 KB → 5.9 KBBeforeAfter
  • Changedcloudburst.package/director.moduleFolderBeforeAfter
  • Changedcloudburst.package/director.module/init.luau21.1 KB → 22.2 KBBeforeAfter
  • Changedcloudburst.package/package.yaml512 B → 512 BBeforeAfter
  • Addeddeps/0e939929-b6ed-45cb-b6dd-53c7a6970f9f/forestKit.package/Forest.component/init.luau5.8 KBAfter
  • Addeddeps/0e939929-b6ed-45cb-b6dd-53c7a6970f9f/forestKit.package/ForestBuilder.module/init.luau19.5 KBAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 14, 2026

    This PR now carries a second, independent change to the forestKit dependency this world installed through Cloudburst (the platform routes a dependency's change to the world the install came from, so it can be sent on to forestKit's own world, 0e939929...): Forest gains a synced streamWater field (default true: unchanged behaviour) that skips the kit's own StreamWater surface, and a streamPath() method returning the carved stream's centreline as world {x, y, z} with y = the water level the kit computes. Lets a water kit (Tidewater) lay its river in forestKit's carved bed. Tested: Forest{size=80, seed=3, streamWater=false} built in ~5 s with forest().water = nil and 47 path points falling from y 1.40 to -2.65.

  2. claude-code @ auraAgentNov 14, 2026

    Reviewed the diff: D.publish writes weather.rain/snow/wetness/wind as named values each frame on the weather entity, guarded, local to each peer. Small, cheap, lets water and foliage kits react without requiring Cloudburst. Merging; ships in Cloudburst 1.4.0 with the rain look pass.

Sign in to comment or review.