Log inGet started
World

Floating Island Forge

Merged

FloatingIsland.clear: let a game keep paths and lines of sight free of the look's dressing

#6
Author
claude-code @ auraAgent
Opened
Nov 16, 2026
From
contrib-9e4124ab
Into
main
Merged
Nov 16, 2026

Found building a grappling-hook race on islands grown by floatingIslands 1.0.9 (through skyhookRace with world.dressing = false). Each island's look dressing scatters rocks, trees and crystals anywhere on the top, and a game has no way to keep an area free. On a race course a merged island_props collider beside a checkpoint blocked the line of sight to the next grapple ring: physics.raycast from the checkpoint hit island_props 5.8 m out, and the hook's aim assist jumped to another target 57 degrees off.

Adds an opt-in clear list, which is empty by default, so every existing island builds exactly as before:

  • FloatingIsland.component: new field clear = Field.string('', Sync, ...), circles in the island's own metres as 'x,z,r;x,z,r'. options() parses it into opts.clear = { {x, z, r}, ... }, and keyNow() includes it so a change rebuilds the island.
  • islands.module: IslandOpts gets clear: { {number} }?. M.scatter skips any candidate point inside a clear circle, so every dressing kind that places through scatter honours it.
  • README: the field in the component table and the options list, plus a changelog line under 'Unreleased' for you to release as you see fit (version left at 1.0.9).

Verified in a world: with clear set to lanes on an island, raycasts from its checkpoint to the rings of the next gap are clear, where they were blocked before. Islands without clear are unchanged.

skyhookRace (separate pull request on its own world) sets clear only where the installed FloatingIsland declares it, so it works with 1.0.9 as before and gains the clear lanes once this is released.

Source world: 298d3ce1-4e82-48a6-aaaa-983f24ffd86c Contributed paths:

  • floatingIslands.package/FloatingIsland.component/init.luau
  • floatingIslands.package/README.md
  • floatingIslands.package/islands.module/init.luau
  • floatingIslands.package/FloatingIsland.component
  • floatingIslands.package/islands.module
  • floatingIslands.package/gallery.scene/authoring/state.json
  • floatingIslands.package/gallery.scene/build.luau
  • floatingIslands.package/gallery.scene/scene.json
  • floatingIslands.package/tests/floatingIslands.testSuite/init.luau

5 files changed

  • ChangedfloatingIslands.package/FloatingIsland.componentFolderBeforeAfter
  • ChangedfloatingIslands.package/FloatingIsland.component/init.luau8.9 KB → 9.5 KBBeforeAfter
  • ChangedfloatingIslands.package/README.md13.1 KB → 13.7 KBBeforeAfter
  • ChangedfloatingIslands.package/islands.moduleFolderBeforeAfter
  • ChangedfloatingIslands.package/islands.module/init.luau54.7 KB → 54.9 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.