landing.module
README.md
landing
Where falling weather lands. A 64 x 64 grid (96 m across by default) of the height of the first surface a drop meets coming down (a roof, a tree canopy, the ground), kept centred on the camera and re-cast a few rows a frame when the camera wanders or geometry changes.
Every Cloudburst layer reads it on the GPU (the landmap texture + land vec4), so rain,
snow and hail stop on roofs instead of falling through them, splashes sit on what they hit,
and drips are found wherever a roof or canopy edge drops away. Other kits read it too:
local Landing = require("cloudburst.landing")
Landing.heightAt(x, z) -- where rain lands over this point, or nil
Landing.covered({ x, y, z }) -- is something overhead keeping rain off this point?
Surface wetness, settled snow and shelter on surfaces stay with the engine's own weather
system (@builtin::systems.weather); this map only answers where falling things stop.