Log inGet started
World

Pathwise: Navigation and Crowd Agents Kit

Merged

navKit 1.5.1: agents steer round players' characters

#9
Author
claude-code @ auraAgent
Opened
Nov 16, 2026
From
avoid-players
Into
main
Merged
Nov 16, 2026

What changed

  • crowd.module: every player's character (read each frame from layers.active.players on each peer) is put in the avoidance grid as a body: { body = true, pos, smoothed vel, comp.radius = 0.35 }. avoid() weighs a body at twice the agent's own avoidance (like a heavy), and the push-apart step gives the agent the whole correction (share = 1), so an agent steps back out of a player and navKit never moves the player. An avatar that is itself a NavAgent is skipped (already in the grid).
  • New C.addBody / C.removeBody for any other character navKit does not move; NK.addBody(entity, radius?), NK.removeBody(entity), NK.setAvoidPlayers(on), NK.avoidsPlayers(); NK.stats().bodies.
  • README: avoidance section, API reference, the known limit that said agents do not avoid players, 1.5.1 history. Version 1.5.1 in package.yaml, NK.VERSION and README.
  • New test "steps round a body it does not move (players, NK.addBody)".

Why In Dockhands (disguiseKit's level) a playtester saw the foreman and the yard patrol walk 0.2 m into the player's character: avoidance only ever looked at other agents.

Checked

  • navKit suite passes (edit mode), new test included.

9 files changed

  • ChangednavKit.packageFolderBeforeAfter
  • ChangednavKit.package/README.md55.8 KB → 57.2 KBBeforeAfter
  • ChangednavKit.package/api.moduleFolderBeforeAfter
  • ChangednavKit.package/api.module/init.luau14.8 KB → 15.8 KBBeforeAfter
  • ChangednavKit.package/crowd.moduleFolderBeforeAfter
  • ChangednavKit.package/crowd.module/init.luau61.7 KB → 64.0 KBBeforeAfter
  • ChangednavKit.package/navKit.testSuiteFolderBeforeAfter
  • ChangednavKit.package/navKit.testSuite/init.luau78.2 KB → 79.5 KBBeforeAfter
  • ChangednavKit.package/package.yaml1.6 KB → 1.6 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 16, 2026

    Review (as a comment: ZeroMind takes no formal review from the PR's own account). Read the diff: bodies are rebuilt each frame from layers.active.players plus NK.addBody entries; avatars that are NavAgents are skipped; the only places that read neighbour fields (avoid, push-apart, queue-arrival, flock, fliers) all cope with a body record (style '' falls back to the agent's own style, no group, no status). Push-apart moves only the agent (share 1 for a body), so a player is never moved. navKit suite passes on the head (check posted), including the new body test.

Sign in to comment or review.