Log inGet started
World

Pathwise: Navigation and Crowd Agents Kit

Merged

navKit 1.5.5: standing agents write no transform; tick phase timers

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