Findnearactor

From EDukeWiki
Revision as of 17:14, 11 March 2009 by Herejex (talk | contribs)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

findnearactor <actor> <distance> <gamevar>

Gets the actor ID of the closest <actor> within <distance> into a <gamevar>. If no actor within range is found, the gamevar is set to -1. The input for <actor> may be its tile number (example: 2000) or its defined name (example: PIGCOP). The <distance> will be determined on the x and y plane only; for finding actors on the x, y, and z axes use findnearactor3d instead.

By getting the actor ID of a nearby actor, the current actor can use getactor/setactor to edit the properties of the target actor or getangle to face the target actor, among other potential uses.

Also note that if the <actor> being located within the <distance> is asleep this will return a value of -1

See also findnearsprite.