NatureGL Weatherv1.1.0

More

Changelog

Every release of naturegl-weather. The package follows semantic versioning.

#1.1.0

2026-09-24 Composition with NatureGL Water.

#Added

  • WeatherSystem.create({ layer }), weather.setLayer(layer) and weather.particleMeshes. They put rain, splashes, snow and lightning on one render layer, such as water.overlayLayer, so NatureGL Water draws them after (over) the water surface. Read more.
  • README: "Composing with naturegl-water", covering the overlay layer, fog.sceneFog = false and lighting from NatureGL Sky.

#1.0.0

2026-09-24 The first packaged release, ported from weatherpro.html.

#Added

  • The WeatherSystem facade: create, update, render, resize, loadPreset, set, getParams, setQualityLevel, setLighting, patchMaterial, setOccluders, strike, on and dispose.
  • Standalone subsystems: RainSystem, SnowSystem, LightningSystem, FogSystem, SurfaceWeather, WeatherAudio, OcclusionMap and WeatherPipeline.
  • Seven presets as data files (clear, drizzle, downpour, thunderstorm, snowfall, blizzard, foggyDawn) and four quality levels.
  • A plain renderer.render() path, with a THREE.FogExp2 fallback and a puddle sky-tint fallback when there's no environment map.
  • A camera-following occlusion map, and setOccluders().
  • Shelter: patched surfaces stay dry and snow-free under occluders, with soft, wind-slanted edges.
  • Snow settles on roof slopes (by the face normal) and is shaded with it. Snow glints and cool-blue shade; flake glints and wind stretch.
  • A rain streak profile with a bright head, per-drop brightness, and forward-scatter glow toward the sun and moon.
  • Raindrop rings in the SSR puddle reflections.
  • Lightning in-scattering in the volumetric fog. strike and thunder events. A demo sky with a cloud-structured flash core.
  • Demo: the village square with the original UI, Copy preset JSON (button and C), and window.__pro.
  • A headless GPU smoke test (npm test), and screenshot, before/after and perf helpers in scripts/.

#Changed from the page

  • three r160 (CDN) → ^0.186 (npm). THREE.Clock → THREE.Timer. PCFSoftShadowMap → PCFShadowMap, with depth-texture shadows sampled with sampler2DShadow in the fog pass.
  • Quality key med → medium.
  • Preset keys thunder → thunderstorm and foggy → foggyDawn.
  • Preset fields renamed:
weatherpro.htmlNatureGL Weather
lightlightning
windDirwindDirection
fogIfogLight
fogHsfogHeight
expexposure
wetwetness
coversnowCover