sdk.world_navigation

Asynchronous multi-floor route planner. Heavy WorldGrid A* runs on the MapService worker; the game thread executes only a small semantic action graph made of bounded walking legs and verified transition actions. CaveActionGraph is deliberately resolved lazily: callers which inject a scoped factory and broker must never fall through to the process-global graph/broker pair.

local M = require("sdk.world_navigation")

Constants

Lua 5.4 has no enums — these are integer (or string) fields on the module.

Name	Value	Summary
Navigator	Navigator	World navigator class.
graph_from_path	graph_from_path	Build a navigation graph from a path hit.

new

function · new(opts)

Construct a Navigator. CaveActionGraph is resolved lazily, never at new(). Injected factory/broker must not fall through to the process-global pair.