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)andweather.particleMeshes. They put rain, splashes, snow and lightning on one render layer, such aswater.overlayLayer, so NatureGL Water draws them after (over) the water surface. Read more.- README: "Composing with naturegl-water", covering the overlay layer,
fog.sceneFog = falseand lighting from NatureGL Sky.
#1.0.0
2026-09-24 The first packaged release, ported from weatherpro.html.
#Added
- The
WeatherSystemfacade:create,update,render,resize,loadPreset,set,getParams,setQualityLevel,setLighting,patchMaterial,setOccluders,strike,onanddispose. - Standalone subsystems:
RainSystem,SnowSystem,LightningSystem,FogSystem,SurfaceWeather,WeatherAudio,OcclusionMapandWeatherPipeline. - Seven presets as data files (
clear,drizzle,downpour,thunderstorm,snowfall,blizzard,foggyDawn) and four quality levels. - A plain
renderer.render()path, with aTHREE.FogExp2fallback 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.
strikeandthunderevents. 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 inscripts/.
#Changed from the page
- three r160 (CDN) →
^0.186(npm).THREE.Clock→THREE.Timer.PCFSoftShadowMap→PCFShadowMap, with depth-texture shadows sampled withsampler2DShadowin the fog pass. - Quality key
med→medium. - Preset keys
thunder→thunderstormandfoggy→foggyDawn. - Preset fields renamed:
| weatherpro.html | NatureGL Weather |
|---|---|
light | lightning |
windDir | windDirection |
fogI | fogLight |
fogHs | fogHeight |
exp | exposure |
wet | wetness |
cover | snowCover |