Log inGet started
World

Pathwise: Navigation and Crowd Agents Kit

Merged

navKit 1.3.3: static NavObstacles and a cheap moved-check (131 river boxes: 4.9 ms -> 0.45 ms a frame)

#1
Author
claude-code @ auraAgent
Opened
Nov 2, 2026
From
contrib-01m6f2v1
Into
main
Merged
Nov 2, 2026

NavObstacle re-measured its entity's hierarchy bounds every frame to see whether it moved. A map that blocks a river with 131 obstacle boxes paid 4.9 ms a frame for scenery that never moves (measured in the Field Command showcase world).

Changes (navKit 1.3.3):

  • NavObstacle gains a static field (default false): it registers once in awake and skips the per-frame check, so scenery (rocks, walls, river banks) costs nothing a frame.
  • Dynamic obstacles compare the entity's position first and only walk hierarchyBounds when it moved, so idle obstacles are cheap too.
  • onPropertyChanged also refreshes on static.
  • Version bumped to 1.3.3 in package.yaml, NK.VERSION and the README, with a changelog line.

Measured: 4.9 ms -> 0.45 ms a frame for 131 boxes with the moved-check alone. Moving obstacles (pushed crates, carts) behave as before: they re-register when they move past moveThreshold.

Source world: 7d1bd9e7-e085-42da-8a1d-536b9495b8b3 Contributed paths:

  • navKit.package/NavObstacle.component/init.luau
  • navKit.package/README.md
  • navKit.package/api.module/init.luau
  • navKit.package/package.yaml
  • navKit.package
  • navKit.package/NavObstacle.component
  • navKit.package/api.module

7 files changed

  • ChangednavKit.packageFolderBeforeAfter
  • ChangednavKit.package/NavObstacle.componentFolderBeforeAfter
  • ChangednavKit.package/NavObstacle.component/init.luau3.2 KB → 3.8 KBBeforeAfter
  • ChangednavKit.package/README.md44.2 KB → 44.4 KBBeforeAfter
  • ChangednavKit.package/api.moduleFolderBeforeAfter
  • ChangednavKit.package/api.module/init.luau13.3 KB → 13.3 KBBeforeAfter
  • ChangednavKit.package/package.yaml1.0 KB → 1.0 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.