IMM_PATH
Keywords: IMM_PATH, WIZ_PATH
=== STAFF MANUAL ===
Usage: path <keyword>
path .<full name>
Description:
Compute and display the shortest route from the room you
are currently standing in to a target character. The result
is a compact string of direction letters -- one letter per
step -- so you can paste it back into the movement system
to walk the path, or hand it to a player who needs
directions.
Search Modes:
path <keyword> ...... Runs Path2Name against the target
name. Matches by keyword, so
path guard finds the first
reachable guard. The search uses
HUNT_THRU_DOORS, which means the
routing walks through closed doors
but does not cross zone
boundaries.
path .<full name> ... Prefixing the argument with a dot
switches to Path2FullName and an
exact-name match. This mode adds
HUNT_GLOBAL, so the search will
cross zone boundaries to reach the
target -- use it when the target is
known to be in a different zone.
Both modes use a maximum search radius of 200 rooms.
A target beyond that distance, or in an unreachable room,
returns "Can't find target.".
Output:
On success the command prints:
Shortest route to <target>:
<direction letters>
The direction letters are the first character of each
step (n / e / s / w / u / d) laid out in the order
you would actually walk them.
On failure -- empty argument, missing target, or no path
within the search radius -- you see one of:
Find path to whom?
Can't find target.
Restrictions:
- Available to any immortal. No permission flag is
checked; the level gate in the command table is the
only guard.
- The current room is the source of the path; there
is no way to pass a different origin. If you need a
route starting elsewhere, goto that room first.
Notes:
- The plain path form cannot cross zones. If the
target is known to be outside the current zone, use
the dotted form even if you already know the exact
name.
- The step list walks through closed doors; the
command does not check whether you personally can
open or pass them. Unlocking and opening are up to
you.
- This command is a read-only sibling of hunt: it
prints a path instead of attaching one. For a mob
that should actively chase, use hunt.
=== END MANUAL ===