Log inGet started
World

Tidewater: Oceans, Lakes, Rivers, Waterfalls, Swimming and Splashes Water Kit

Branchmain
Commit431c1b9967

README.md

showcase

A walk-and-sail showcase of the Tidewater water kit: one world where every kind of Tidewater water sits in a place that suits it. Players spawn on the pier, looking out along it at the moored boats.

The coast. tropicalKit's cove island stands at the centre, ringed by a Tidewater ocean on the tropicalLagoon preset that shoals to glassy turquoise against the island's sand and reef. The island's old wooden pier is the dock: a rowboat and a speedboat from vehiclesKit (synced vehicles, drivable, buoyant on the Tidewater sea) are moored either side of its sea end, and each leaves a Tidewater Wake as it moves. Anything that falls into any water splashes, a player stepping off the pier included.

The falls. North of the island, forestKit's beech forest stands on a rock mesa about 16 m up, its faces dressed with tropicalProps' layered cliff walls and sea stacks. Its carved stream runs as a Tidewater river that steepens into white rapids, pours off the mesa's south face as a waterfall into a plunge pool ringed with mossy boulders, and spills out as a brook to the sea. Stone steps climb the cliff beside the fall.

The town lies east of the island: a stone quay of Lanternwake cottages just after rain, with puddles in the low spots of the cobbles, drips falling from the eaves, street lamps, bollards and a landing stage where a boat can tie up, and tumbled rock along the quay's foot.

Signposts name each area, and three glowing travel pads carry a walker from the pier to the falls, the falls to the town, and the town back to the pier. worldClockKit runs the day, drives the sun and moon and lights the lamps; Cloudburst passes a light shower every few minutes whose rain rings the river, the pool and the puddles. An AgX grade (global PostProcess) sets the tone.

How it is built

  • build.luau is the whole layout (re-runnable; entities keep their ids). entrypoint.luau runs the pads, the eave drips and the soundstage ambience beds while playing.
  • Lighting: the build's sun/ambient lights are driven by worldClockKit (drivesLighting, sun capped at 7.5). The ProceduralSky's syncSunToLight is OFF on purpose: with it on, the sky writes a physical-scale sun (~33-40) into the light and Cloudburst adopts that as its base, which whites the whole scene out.
  • Multiplayer: boats are entity.spawnSynced vehicles (vehiclesKit), the ocean runs on Physics.waterTime (the shared water clock), Splashes plays splashes with sync = true, and the WorldClock/Weather entities are synced.

Known issues

  • Loading is slow: Island (12k props), the forest, three WaterBodies and ~110 tropicalProps instances build at load. Measured 69-115 s on a quiet engine, 15-65 min on the shared engine under heavy load from other clients.
  • The ocean has ground = island; the tidewater notes report garbage displacement + disptex not GPU-resident errors for an ocean with ground set — not seen as a wall of water here in edit captures, but watch for it.

Lighting and time of day

The sky drives the sun through the day and night. Its noon strength is physical-scale, so entrypoint.luau caps the light at 4 every frame (SUN_CAP), and Cloudburst's own lighting is off. Pictures at day, dusk and night are in media/ (coast_day.jpg, coast_dusk.jpg, coast_night.jpg, boat_wake_night.jpg).