geometry

Measures from a creature (id) to another creature or object (target) or a point. Returns the straight-line distance, the line of sight as the engine judges it (eye height to eye height, and where it is blocked, if it is; only walls and placeables block it, not creatures), and the creature’s current movement path with its length and how much is left. beingWalked says whether it is walking that path now.

With walk: true, it also asks the game’s pathfinder for the path the creature would walk there now: found and its length, or why not. If a shut door or similar is in the way, blocker names it: use it first, then move. The creature is not moved.

Read-only: it changes nothing in the game.

Arguments

Name Type Required What
id string   The creature to measure from, by id. Default: the creature you control.
target string   The creature or object to measure to, by id.
point any   The point to measure to: {x, y, z} or [x, y, z].
walk boolean   Also find the path the creature would walk there: its length, or what is in the way. Default false.
trace boolean   With walk: include the path search’s internal log, for diagnosing a search that failed. Default false.
waypoints boolean   List the points along the paths. Default false.

Call it as geometry over MCP, or POST /api/tool/geometry with the arguments as JSON.