Log inGet started
World

Beechwood Brook: A Temperate Forest to Walk, with Trees, Undergrowth and a Forest Builder

Merged

forestKit 0.3.0: level pads (flats) for hand-designed levels, plus robustness when entities vanish mid-scan

#6
Author
claude-code @ auraAgent
Opened
Nov 11, 2026
From
contrib-mwjcwdhf
Into
main
Merged
Nov 11, 2026

Adds an optional flats setting (Forest component field, ForestBuilder BuildOpts, Ground SiteOpts): a list of { x, z, w, d, h?, blend? } rectangles where the ground lies exactly at height h (default 0), reads as an open grassy clearing with no trees or undergrowth, and eases back into the land over blend metres (default 10). Included in the ground cache key and the component's rebuild key; forests without flats are unchanged. Used for a tower defense map that needs a flat 88 x 64 m field inside a beech forest.

Robustness: ForestBuilder.followBodies, Atmosphere.ensureSky and worldClockKit's director (findLights, findEngineSky) read components of every entity from entity.findAll(); an entity vanishing between the scan and the read (another peer's editor presence, a mid-frame despawn) threw and disabled WorldClock / ForestAtmosphere, and spammed editorUpdate errors each frame in multi-client sessions. Those reads are now pcall-guarded. worldClockKit bumped to 1.4.8.

Checked: toon beech forest (size 170, seed 11) with flats {0,0,88,64,h=0,blend=15} builds a flat clearing ringed by forest; with two clients in one room the errors no longer appear.

Source world: 37a76806-2009-4346-8a3a-e0c90581eb7b Contributed paths:

  • worldClockKit.package/director.module/init.luau
  • worldClockKit.package/package.yaml
  • forestKit.package/Atmosphere.module/init.luau
  • forestKit.package/Forest.component/init.luau
  • forestKit.package/ForestBuilder.module/init.luau
  • forestKit.package/Ground.module/init.luau
  • forestKit.package/package.yaml
  • forestKit.package
  • forestKit.package/Atmosphere.module
  • forestKit.package/Forest.component
  • forestKit.package/ForestBuilder.module
  • forestKit.package/Ground.module
  • worldClockKit.package
  • worldClockKit.package/director.module
  • deps/a8c1db81-44f9-4da4-a9a5-4dc8095cdd7f/materialLibraryKit.package/Materials.module/init.luau
  • forestKit.package/Ambience.module/init.luau
  • forestKit.package/Footsteps.module/init.luau
  • forestKit.package/Rules.module/init.luau
  • forestKit.package/StreamWater.module/init.luau
  • forestKit.package/atmosphere/ForestAtmosphere.component/init.luau
  • forestKit.package/tests/atmos.testSuite/init.luau
  • forestKit.package/tests/forestKit.testSuite/init.luau
  • scenes/main.scene/build.luau
  • showcase/Showcase.component/init.luau

14 files changed

  • ChangedforestKit.packageFolderBeforeAfter
  • ChangedforestKit.package/Atmosphere.moduleFolderBeforeAfter
  • ChangedforestKit.package/Atmosphere.module/init.luau24.9 KB → 24.9 KBBeforeAfter
  • ChangedforestKit.package/Forest.componentFolderBeforeAfter
  • ChangedforestKit.package/Forest.component/init.luau4.8 KB → 5.5 KBBeforeAfter
  • ChangedforestKit.package/ForestBuilder.moduleFolderBeforeAfter
  • ChangedforestKit.package/ForestBuilder.module/init.luau19.4 KB → 20.3 KBBeforeAfter
  • ChangedforestKit.package/Ground.moduleFolderBeforeAfter
  • ChangedforestKit.package/Ground.module/init.luau21.1 KB → 22.3 KBBeforeAfter
  • ChangedforestKit.package/package.yaml823 B → 822 BBeforeAfter
  • AddedworldClockKit.packageFolderAfter
  • AddedworldClockKit.package/director.moduleFolderAfter
  • AddedworldClockKit.package/director.module/init.luau23.5 KBAfter
  • AddedworldClockKit.package/package.yaml913 BAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.