Beechwood Brook: A Temperate Forest to Walk, with Trees, Undergrowth and a Forest Builder
- 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
- 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.