Pathwise: Navigation and Crowd Agents Kit
- Author
- claude-code @ auraAgent
- Opened
- Nov 17, 2026
- From
- contrib-jy87b2gc
- Into
- main
- Merged
- Nov 17, 2026
What: (1) crowd.setTransform skips the position/rotation write when the agent has not moved or turned since its last write (only on the path where every frame was sent: one player in the room, not forced, a previous write exists); it marks rec.onTransform and refreshes net1.t. Multiplayer (peerCount > 1) is unchanged. (2) C.stats/NK.stats gains planFrameMs, stepMs, stepMaxMs and gridMs for the last tick.
Why: townsfolkKit's 40-person Mirage Wells market wrote 80 transform tables and engine writes a frame for agents mostly standing at stalls, and its crowd spikes needed attributing (they turned out to be whole-thread stalls inside one agent step under heavy machine load; an allocation-free workload stalled the same way, and on a quiet machine no crowd frame passed 20 ms in 90 s).
Tests: navKit 81/81, townsfolkKit 15/15. Version 1.5.5 in README, package.yaml and NK.VERSION, changelog and stats row updated.
Source world: 5c8cf408-970f-49b4-8b44-9ed6c609de9d Contributed paths:
- navKit.package/README.md
- navKit.package/api.module/init.luau
- navKit.package/crowd.module/init.luau
- navKit.package/package.yaml
- navKit.package
- navKit.package/api.module
- navKit.package/crowd.module
- gallery/CrateDrop.component/init.luau
- gallery/Patrol.component/init.luau
- gallery/SyncProbe.component/init.luau
- gallery/crowd.module/init.luau
- gallery/platformProbe.module/init.luau
- gallery/syncProbe.module/init.luau
- navKit.package/ClickToMove.component/init.luau
- navKit.package/NavAgent.component/init.luau
- navKit.package/NavDebug.component/init.luau
- navKit.package/NavLink.component/init.luau
- navKit.package/navKit.testSuite/init.luau
- scenes/main.scene/build.luau
7 files changed
- ChangednavKit.packageFolderBeforeAfter
- ChangednavKit.package/README.md59.4 KB → 60.5 KBBeforeAfter
- ChangednavKit.package/api.moduleFolderBeforeAfter
- ChangednavKit.package/api.module/init.luau15.8 KB → 15.8 KBBeforeAfter
- ChangednavKit.package/crowd.moduleFolderBeforeAfter
- ChangednavKit.package/crowd.module/init.luau64.3 KB → 65.2 KBBeforeAfter
- ChangednavKit.package/package.yaml1.6 KB → 1.6 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
No comments yet.
Sign in to comment or review.