Log inGet started
World

Pathwise: Navigation and Crowd Agents Kit

Merged

navKit 1.5.4: a standing agent on the peer that moves it skips the visual step

#11
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.