Findnearsprite

findnearsprite <tile number> <distance> <gamevar>

Gets the actor ID of the closest sprite of with a picnum of <tile number> within <distance> into a <gamevar>. If no sprite within range is found, the gamevar is set to -1. The input for <tile number> 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 sprites on the x, y, and z axes use findnearsprite3d instead.

Note that findnearsprite and friends work just like findnearactor and friends, except that the sprite commands will find sprites of any statnum, including sleeping actors and sprites that are not actors.

Also see findnearactor.