guide.md
Versions
Every version of this package its world published, newest first by when it first appeared. A version published again later keeps its place.
Comparing from 01M7FFKWPX2GY1VDFYMERKC4HV. Pick the version to compare it with. Cancel
tidewaterSwim 1.0.0: Swimmer component (wade, swim, tread, dive, climb out via climbKit), four feels, swim input map, README, guide; install climbKit 1.1.35 --- tidewater 1.2.0 work: toy look (look_mode 6) in every water and effect shader, tide (WaterBody tide/tidePeriod, shared water clock), typed Water.surfaceAt/normalAt/tideAt + handle queries, backyardPool, plain-word variety names; own sources name tidewater.components.Ocean/Buoyancy --- NOTES: round 14 swimming (helper swim) --- Showcase: raft, barrels, logs, marker buoys in the harbour and four crates the forest river carries over the falls (owner recycles them to the river head); all plain physics bodies with Tidewater Buoyancy --- Water.setQuality / quality / batterySaver; follows Graphics Presets steps by itself (Battery Saver and Low take the low tier); Water.floatBodies for ragdolls; showcase: Graphics Presets battery-saver ladder, swimming for every player (tidewaterSwim), a floating tumbleTroupe ragdoll; install graphicsPresets and tumbleTroupe --- Showcase harbour: a 1 m tide on an eight-minute cycle (verified in play: tide, sea surface and the moored rowboat fall together) --- Lakeside scene: alpine lake with a dock on pilings, a ladder swimmers climb out by, a vehiclesKit rowboat with a wake, floating crates, log and buoy, a raised backyard pool on the meadow; every Tidewater ready-made scene's player swims when tidewaterSwim is installed --- tidewater 1.2.0, tidewaterFx 1.1.0: every water effect accepts the toy look (candy palette, glossy drops); tidewater depends on tidewaterFx 1.1.0 --- vehiclesKit 1.1.10 and tropicalKit 1.2.4: work without the engine's removed built-in ocean (released upstream: vehiclesKit PR #1, tropicalKit PR #13); NOTES round 14 upstream kits --- Showcase and Lakeside scene saves after their rebuilds (floaters, tide, swimmer, dock, pool) --- docs: Tidewater is the water (no engine ocean); seven looks with toy; tide, typed queries, varieties; 11 new how-to guides and a harbour example; swim cross-links --- 1.2.0 costs measured twice per tier, look_mode range 0..6 in every water shader, notes --- Upgrade @builtin 05c0bd2 to b42cf47 (the engine without its own ocean); tidewater 1.2.0, tidewaterFx 1.1.0, tidewaterSwim 1.0.0 --- Showcase rebuilt and saved; remove an orphaned copy of the removed built-in ocean module that no install records; refresh the ocean material preview --- Guide metadata and the looks README into the commit --- Stage guide metadata and looks README --- Re-index four guides' metadata and the looks README --- Re-register four new guides as guide assets (waterfall, river carries things, change the look, puddles)
01M7ZT5YYAFE8CV96K9AD7CN5M4463a3c19dBrowse filesCompare with this versionTidewater 1.1.12: river docs say where the water lies, what goes in options, path is a string (issue #11, via lanternStair PR #6); current engine library (33551d3)
01M7KDKSV9HDZWTYCGBH6BBVFWddfe088144Browse filesCompare with this versiontidewater 1.1.10, tidewaterFx 1.0.9: heightAt/flowAt with no height answer the topmost water (a lake over the sea answers the lake); a water asked about itself (handle:heightAt, WaterBody:heightAt/flowAt) answers only for itself; docs say so; @builtin upgraded to e35f2ea
01M7HJDY5AFSYDWRHE700Z3ZTB1d93beba78Browse filesCompare with this versionOcean: built-in savings carried over (a still sea dispatches nothing, scene read through zero::scene_color/depth, no per-frame mesh re-mirror); switching packages keeps the built-in look by default; docs: 11 kinds and 6 looks everywhere; README five-minute section fixed from a fresh-world run; cost bench takes a render tier --- tidewater 1.1.9, tidewaterFx 1.0.8: two-player boat height, wake, splashes and ripples re-checked twice (second after a reload); idle boats aground return to their berth in the showcase; README multiplayer, cost (tablet gap explained) and limits; cover of coast, falls and wet street; notes and reuse ratings
01M7HFQ9QQAJC4XMM0Q0213KV1e522ca0b45Browse filesCompare with this versionFresh-install fixes (Ocean swap resolves Tidewater's component, seabed material, README quick start), cost bench saves results + pause-menu button, showcase boat moorings, notes --- Waterfall plunge spray uses the continuous spindrift effect (spray is one-shot); prime readies spindrift; vehiclesKit 1.0.12 controls fix (sent upstream as PR #1); showcase scene save --- Upgrade @builtin to f6ed3ff --- tidewater 1.1.5, tidewaterFx 1.0.4: Known limits cite issues #1-#10, spindrift in docs, notes
01M7G9DE9F9MFN05QJ44H2XAW58380615ebfBrowse filesCompare with this versionreuse-review.md (replaces REUSE.md) rates every part; README and guide examples use component.get (the dotted form did not run); round 4 plan --- Ocean: Tidewater seas use their own names (twocean<N>, own surface owner marker, provider and render targets) so a built-in sea and a Tidewater sea live together; buoyancy damping follows how fast the water moves (gale boxes stay near the surface); platform quality tiers (android low, browser medium, small browser low); sunset/night/day comparisons with the built-in --- tidewater 1.1.2, tidewaterFx 1.0.1: foam emitter fix and ripple work, puddles read as puddles in the rainy street, gallery time of day, underwater work in progress, showcase changes, mountain lake rebuilt
01M7FR2TA1XZNG1SDV43P7XMXSa1e4d389b6Browse filesCompare with this versionPort built-in oceans package into tidewater.package as the starting point --- Tidewater foundation: Water façade, WaterBody component, looks, weather link, architecture contract, plan --- Gallery module + scene, gallery materials; Cloudburst named-value publishing (sent upstream as PR #1) --- Repin @builtin; forestKit streamWater/streamPath (sent upstream via Cloudburst PR #1) --- tidewater ocean: kind_ocean, five looks in oceanSurface, wake foam layer + Ocean.stampFoam, bounded seas, shared underwater pass, sea variant presets --- Showcase scene: tropicalKit coast, forestKit plateau on a mesa, Lanternwake quay town, clock + Cloudburst weather --- tidewater surfaces: waterSurface shader, twCommon, GPU ripple field, lake/pond/pool/puddles kinds --- rivers: river + stream kinds, riverPath spline/ribbon/flow-grid helpers, riverSurface + riverBed shaders --- tidewater fx: water effects (plop, body, droplets, spray, bow, spindrift, mist, drips, bubbles, wake) in five looks, Fx module, Wake and Splashes components, tests --- tidewater ocean: pixel/lowpoly gradient-correct sampling, cartoon crest caps, bounded seas, temporary internal entities, underwater clock wrap, oceanLooks + underwater suites --- rivers: waterfall kind (feed, ballistic sheet, plunge pool, cliff, fx), stream presets, twCommon-based riverSurface with pool mode, waterfallSheet shader, rivers test suite, READMEs, NOTES --- tidewater surfaces: clock wrap, caustics on floors+walls, organic shores + bed texture, look fixes, puddle damp film, setFocus/clock API, surfaces test suite (13 passing), READMEs, NOTES --- tidewater ocean: fold the foam dispatch so the ultra tier's 2048 field runs (was 65536 workgroups, over the 65535 limit) --- Water registry survives reloads; temporary option; notes from ocean/surfaces/rivers --- Tidewater README (credits built-in oceans), package description 1.0.0, plan progress --- tidewater fx: per-layer outputs, wake water query fix + status field, notes --- tidewater fx: waterfx effect graphs (per-layer outputs) --- Tidewater guides: how to add water to my game, and the fishing dock example; docs notes --- oceans guide metadata --- tidewater fx: Wake steps on its own clock-guarded task, wake as dropped foam segments (wakefoam), bow spray rides the hull, status field, despawn guard --- Ready-made scenes (scenes agent), Wake rework (fx), ocean: hold displace/seabed until the displacement textures are GPU-resident --- tidewater scenes: six starter scenes (tropicalLagoon, northernGale, mountainLakeDawn, forestRiver, rainyStreet, waterfallGrotto), their terrain graphs, materials and the sceneKit builder --- Showcase: Tidewater sea round the island, boats with wakes, river/waterfall/pool/brook on the mesa, cliff steps, town puddles and eave drips, signposts and travel pads --- WaterBody: stable ground key in rebuild signature; notes --- Commit installed kits (tropicalKit, vehiclesKit), the island's cooked ground and the Cloudburst/forestKit changes; ignore procgen cache --- Water surface: ripple, splash and rain rings visible (lit crest ring, drawn ring in stylised looks) --- Underwater works for player cameras (world position, pass survives reloads, in-water grade); ocean sea variants re-read before a preset is refused --- Tropical lagoon is a calm lagoon (wind 3, amplitude 0.35): floating boxes stay within 4 to 6 cm of the surface --- Puddles stay separate patches when soaked; wet and dry pictures of the same street --- Splashes happen by themselves: the water module starts automatic splashes with the first water (Water.autoSplash(false) to opt out) --- Effects: footstep, fishJump, rainSplash (one-shots) and foam (continuous), 14 effects in five looks --- Three new kinds (shoreline, hot spring, underwater): 11 kinds x 5 looks = 55; gallery rebuilt without covering slabs, billboard labels, walkways, spawn on stone, time-of-day switch --- Rebuilt the six ready-made scenes (spawns saved), compute shader metadata, showcase README, reuse review, text without long dashes --- README matches the kit (11 kinds, 14 effects, auto splashes, measured floating, puddles, costs marked measured vs estimated); ocean suite skips the reflection cases where the engine has no mirror_wall fixture --- Upgrade @builtin to c8c2eae; fx: one-shots freed after their timeline and capped (40), emitters capped (48), named loop claims so scene loops never double; northernGale surf loop uses a claim --- WIP round 3 (engine stopped mid-work): tidewaterFx package started, crystal look, puddle/underwater/ocean shader work in progress, showcase perf work in progress --- Upgrade @builtin to 81986a6 --- Effects split into tidewaterFx (one copy, own refs, ripple/splash API + named-value route, splashes now build and play, size snapping, warm-up); puddles dry after rain; switching kind keeps water listed; underwater caustics, shafts, Snell window, real sun; crystal look, painted ink, true low-poly facets; media --- Ocean: real-sky lighting on by default (dark dusk, moon path, deep tone, crest glow), crystal shows sand, cartoon/pixel/lowpoly dim at night, shoreline wet sand; fx: emitters stop with their scene/owner, Fx.stopAll, softer mist, glint NaN guards; rivers crate test steps physics; scenes: baked tree meshes + 460 forest trees, rainy street opens wet, ground on terrain for ocean scenes, entrypoint watchdogs stop effects --- Ripple rings visible on lakes (lit/dark ring faces), splashes readied per look (pool 3, Fx.prime on every water body), softer realistic splash rings and foam; showcase: sun capped and driven by the clock, AgX grade, cliff/boulder/quay dressing; Cloudburst director skips dead audio listener (entity('') spam); README: five-minute ocean, six looks, Tidewater FX, known limits; package description; guides list crystal and painted ink --- Rainy street: blue-hour sky, lit (not blown) windows via emissive_intensity, flat road bands with sunk ruts so puddles show, rain on at load in the editor; puddles sample the ground through their own sheet; notes --- Rebuilt tropicalLagoon and northernGale with the ocean shoaling against their terrain (checked: no walls of water); Cloudburst director back to the pre-merge copy; scene pictures --- tidewater 1.1.0 (depends on tidewaterFx 1.0.0)
01M7FFKWPX2GY1VDFYMERKC4HV390a9ed20aBrowse filesPicked