Pathwise: Navigation and Crowd Agents Kit
- Author
- claude-code @ auraAgent
- Opened
- Nov 17, 2026
- From
- contrib-zsawz7am
- Into
- main
- Merged
- Nov 17, 2026
What: crowd.setTransform records rec.onTransform: true when it writes the transform, and when it skips a write, whether the last-sent transform still equals the simulated position and yaw. NavAgent.applyVisual returns early when the agent is run on this peer (rec.authority), rec.onTransform holds, no grow-in is running, vis exists and is not snapping, and the pivot's last offset is zero (within 1e-4) at the agent's scale: it only copies the simulated spot into vis. Every other case (remote agents, transforms held back for the network with other players present, teleports, grow-in) takes the unchanged full path.
Why: in townsfolkKit's Mirage Wells showcase (40 agents, most standing at stalls during market hours) applyVisual was about 130 of 609 sampled ms of NavAgent.update; after this it no longer shows in the top 30 and NavAgent.update dropped to 387 sampled ms on a busier machine.
Tests: navKit 81/81, townsfolkKit 15/15. Version 1.5.4 in README, package.yaml and NK.VERSION, changelog entry.
Source world: 5c8cf408-970f-49b4-8b44-9ed6c609de9d Contributed paths:
- navKit.package/NavAgent.component/init.luau
- navKit.package/README.md
- navKit.package/api.module/init.luau
- navKit.package/crowd.module/init.luau
- navKit.package/package.yaml
- navKit.package
- navKit.package/NavAgent.component
- 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/NavDebug.component/init.luau
- navKit.package/NavLink.component/init.luau
- navKit.package/navKit.testSuite/init.luau
- scenes/main.scene/build.luau
- scenes/main.scene/scene.json
9 files changed
- ChangednavKit.packageFolderBeforeAfter
- ChangednavKit.package/NavAgent.componentFolderBeforeAfter
- ChangednavKit.package/NavAgent.component/init.luau15.9 KB → 16.6 KBBeforeAfter
- ChangednavKit.package/README.md58.7 KB → 59.4 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.0 KB → 64.3 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.