path

Settable:

no

Arguments:

(1) character

(2) room

(3) room, character

(4) room, room

(5) character, character

(6) character, room

Return Value:

integer array

Finds the shortest traversable path between two points. If only one argument is provided, then the path starts "here", meaning in the room that contains the object or character that bears the currently executing MUDL script. The path will not go through closed or otherwise impassable exits, nor will it go through rooms with the nohunt flag set.

The path is returned as an array of integers. The integers are 1, 2, 3, 4, 5, 6 for north, east, south, west, up, down respectively. Thus if you wanted to find the path to %1 and have %c (the character with the executing MUDL script) traverse it immediately, you could say:

   foreach(path(%1),%2,cmd(['north','east','south','west','up','down'][%2]))