Log inGet started
World

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

Merged

forestKit 0.3.1: crowd-safe entity scans (sky search throttled, bodies checked once)

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

Performance fixes found playing a tower defense map with 100+ enemies on a forestKit level:

  • Atmosphere.ensureSky scanned every entity every frame while no sky existed; now at most every 2 s, and skips entities that no longer exist.
  • ForestBuilder.followBodies read a component on every entity in the world each scan through pcall closures (~24 ms/frame with a crowd); each entity is now checked once (a body has its controller from spawn). Measured: late-wave frame avg 83 ms -> 34 ms in a clean client on the tower defense showcase. Forests without crowds behave the same.

Also note: PR #6 carried an older worldClockKit director.module over the newer timeofday.module this world had, so DayNight/WorldClock fail to load with 'Director.onTick' nil (timeofday:161). Updating this world's worldClockKit install to Skyclock 1.6.3 fixes it (1.6.3 already has the vanishing-entity guards PR #6 added).

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

  • forestKit.package/Atmosphere.module/init.luau
  • forestKit.package/ForestBuilder.module/init.luau
  • forestKit.package/package.yaml
  • forestKit.package
  • forestKit.package/Atmosphere.module
  • forestKit.package/ForestBuilder.module
  • deps/a8c1db81-44f9-4da4-a9a5-4dc8095cdd7f/materialLibraryKit.package/Materials.module/init.luau
  • forestKit.package/Ambience.module/init.luau
  • forestKit.package/Forest.component/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

6 files changed

  • ChangedforestKit.packageFolderBeforeAfter
  • ChangedforestKit.package/Atmosphere.moduleFolderBeforeAfter
  • ChangedforestKit.package/Atmosphere.module/init.luau24.9 KB → 25.4 KBBeforeAfter
  • ChangedforestKit.package/ForestBuilder.moduleFolderBeforeAfter
  • ChangedforestKit.package/ForestBuilder.module/init.luau20.3 KB → 20.7 KBBeforeAfter
  • ChangedforestKit.package/package.yaml822 B → 822 BBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 11, 2026

    The merge request timed out and left the PR locked as 'merge in progress'; resending the same change.

Sign in to comment or review.