Log inGet started
World

Turquoise Cay

Merged

tropicalKit 1.2.4: island sea and IslandAtmosphere without the engine's removed built-in ocean

#13
Author
claude-code @ auraAgent
Opened
Nov 21, 2026
From
contrib-waq9tsqz
Into
main
Merged
Nov 21, 2026

Fixes #12

The engine no longer ships @builtin::systems.oceans (the Ocean component and the ocean module). tropicalKit 1.2.3 required that module from Atmos, so IslandAtmosphere failed to load (no time of day, weather, ambience, footsteps or footprints), and the island's own sea and the footstep sea lookup used the removed Ocean component.

What changes (no hard dependency on any water kit):

  • New tropicalKit.IslandSea module: find() the scene's sea, make(parent, groundId, opts) an island's own sea, of(e), seaLevel(e), setGround(e, id), tidewater(). The sea is the Tidewater water kit's ocean (WaterBody, kind ocean, sea state from the Island's oceanPreset, quality from oceanQuality) when the world holds Tidewater, otherwise an engine Water box (4000 m across, 60 m deep) with a flat @builtin water material surface, which bodies float on through FluidForces and Physics.water answers for. Whether Tidewater is there is asked of the entityOps tool, so Tidewater is never pinned as a dependency.
  • IslandBuilder: findOcean, the island's own sea, pointing a scene sea at the island's ground, and letting go of it on destroy all go through IslandSea.
  • Footsteps: ocean() and seaLevel() go through IslandSea.
  • Atmos: no longer requires the removed ocean module. Its per-time sea colour and wind applied to that ocean only; a sea that still takes configure() is still tinted, while Tidewater's ocean and a Water box keep their own look.
  • Docs: README (1.2.4 notes, the ocean/oceanPreset row), the how-to guide. Version 1.2.4.

Verified on the current engine: tropicalKit suite 11 passing, 1 skipped (world isolation), 0 failing. IslandSea.tidewater() answers true with Tidewater installed and the probe falls through to the Water box without it.

Source world: 34465908-dbbb-4f09-b22a-ed8306dea455 Contributed paths:

  • tropicalKit.package/Atmos.module/init.luau
  • tropicalKit.package/Footsteps.module/init.luau
  • tropicalKit.package/IslandBuilder.module/init.luau
  • tropicalKit.package/IslandSea.module/.metadata
  • tropicalKit.package/IslandSea.module/README.md
  • tropicalKit.package/IslandSea.module/init.luau
  • tropicalKit.package/README.md
  • tropicalKit.package/guides/how-do-i-add-a-tropical-island-and-beach-to-my-world.guide/guide.md
  • tropicalKit.package/package.yaml
  • tropicalKit.package
  • tropicalKit.package/Atmos.module
  • tropicalKit.package/Footsteps.module
  • tropicalKit.package/IslandBuilder.module
  • tropicalKit.package/IslandSea.module
  • tropicalKit.package/guides/how-do-i-add-a-tropical-island-and-beach-to-my-world.guide
  • scenes/main.scene/build.luau
  • tropicalKit.package/Ambience.module/init.luau
  • tropicalKit.package/Footprints.module/init.luau
  • tropicalKit.package/Island.component/init.luau
  • tropicalKit.package/IslandAtmosphere.component/init.luau

15 files changed

  • ChangedtropicalKit.packageFolderBeforeAfter
  • ChangedtropicalKit.package/Atmos.moduleFolderBeforeAfter
  • ChangedtropicalKit.package/Atmos.module/init.luau36.9 KB → 37.2 KBBeforeAfter
  • ChangedtropicalKit.package/Footsteps.moduleFolderBeforeAfter
  • ChangedtropicalKit.package/Footsteps.module/init.luau11.7 KB → 11.7 KBBeforeAfter
  • ChangedtropicalKit.package/IslandBuilder.moduleFolderBeforeAfter
  • ChangedtropicalKit.package/IslandBuilder.module/init.luau24.7 KB → 24.4 KBBeforeAfter
  • AddedtropicalKit.package/IslandSea.moduleFolderAfter
  • AddedtropicalKit.package/IslandSea.module/.metadata17 BAfter
  • AddedtropicalKit.package/IslandSea.module/README.md984 BAfter
  • AddedtropicalKit.package/IslandSea.module/init.luau4.2 KBAfter
  • ChangedtropicalKit.package/README.md15.9 KB → 16.7 KBBeforeAfter
  • ChangedtropicalKit.package/guides/how-do-i-add-a-tropical-island-and-beach-to-my-world.guideFolderBeforeAfter
  • ChangedtropicalKit.package/guides/how-do-i-add-a-tropical-island-and-beach-to-my-world.guide/guide.md9.3 KB → 9.5 KBBeforeAfter
  • ChangedtropicalKit.package/package.yaml1.5 KB → 1.5 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.