Log inGet started
World

Turquoise Cay

Closed

tropicalKit 1.2.0: keepClear areas where nothing is scattered

#7
Author
claude-code @ auraAgent
Opened
Nov 15, 2026
From
keepclear-1-2
Into
main
Merge
Has conflicts to resolve first
Closed
SupersededNov 15, 2026

A level builder who places their own buildings and decks on an island (a warehouse on a stilted dock yard by the pier) got palms, bushes and rocks growing through floor and roof: the scatter only kept clear of the island's own stops and pier.

  • New synced field keepClear on Island (Field.table, default {}): circles { x, z, r } and boxes { x, z, w, d, yaw? } (world metres, yaw degrees about +Y, w along the box's X, d along its Z).
  • IslandBuilder.build / planFor accept keepClear; IslandRules.scatter honours it in every layer (palms, shrubs, cover, rocks, cliffs, coral, sea grass, tide-line litter) and for the coconuts dropped at palm feet. ShellHunt keeps its shells out too. IslandRender draws only the given instances, so it needs no change.
  • Rules.clearAreas / Rules.inClear test points.
  • Ground cache unaffected: keyFor (the terrainData name) is unchanged; new placementKeyFor = ground key + hash of the areas, which the Island compares to decide a rebuild. Changing keepClear in edit re-places the props on the saved ground (verified: 67 props in a 30x20 box by the pier -> 0, ground key unchanged).
  • Tests: two new cases (area maths; no prop inside a circle and a turned box, the rest unchanged). 11/11 pass.
  • README "What you set" row + example; version 1.2.0.

26 files changed

  • Changedscenes/main.sceneFolderBeforeAfter
  • Addedscenes/main.scene/authoring/entities/page-01.json7.1 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-02.json1.5 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-04.json6.8 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-06.json3.4 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-08.json2.2 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-0c.json2.1 KBAfter
  • Addedscenes/main.scene/authoring/entities/page-0d.json9.3 KBAfter
  • Addedscenes/main.scene/authoring/state.json24.7 KBAfter
  • Changedscenes/main.scene/scene.json17.2 KB → 18.7 KBBeforeAfter
  • ChangedtropicalKit.packageFolderBeforeAfter
  • ChangedtropicalKit.package/Island.componentFolderBeforeAfter
  • ChangedtropicalKit.package/Island.component/README.md387 B → 521 BBeforeAfter
  • ChangedtropicalKit.package/Island.component/init.luau9.3 KB → 9.9 KBBeforeAfter
  • ChangedtropicalKit.package/IslandBuilder.moduleFolderBeforeAfter
  • ChangedtropicalKit.package/IslandBuilder.module/README.md481 B → 492 BBeforeAfter
  • ChangedtropicalKit.package/IslandBuilder.module/init.luau22.4 KB → 23.2 KBBeforeAfter
  • ChangedtropicalKit.package/IslandRules.moduleFolderBeforeAfter
  • ChangedtropicalKit.package/IslandRules.module/README.md451 B → 644 BBeforeAfter
  • ChangedtropicalKit.package/IslandRules.module/init.luau17.1 KB → 19.1 KBBeforeAfter
  • ChangedtropicalKit.package/README.md13.0 KB → 14.6 KBBeforeAfter
  • ChangedtropicalKit.package/ShellHunt.componentFolderBeforeAfter
  • ChangedtropicalKit.package/ShellHunt.component/init.luau7.9 KB → 8.1 KBBeforeAfter
  • ChangedtropicalKit.package/package.yaml1.5 KB → 1.5 KBBeforeAfter
  • ChangedtropicalKit.package/tests/tropicalKit.testSuiteFolderBeforeAfter
  • ChangedtropicalKit.package/tests/tropicalKit.testSuite/init.luau4.7 KB → 7.2 KBBeforeAfter

Checks

From the author and the world's members

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 15, 2026

    Superseded by #8: the same tropicalKit change without the scene authoring files this branch picked up from the shared staging area.

Sign in to comment or review.