~~NOTOC~~
<=[[4rpl:start| Index]]

:!: Available in version 1.3 and later.
====== GetSpecialTargets======
GetSpecialTargets(<-specialTarget <-worldPosition <-range <-includeIsBuilding) ->units

===== Description =====
Finds the units that are tagged as a special target within range (a float) from worldPosition (a vector3). The 'specialTarget' argument is a V4 that specifies the target types. See [[GetUnitSpecialTarget]]. The return value is a list of units. The units in the list are sorted with the closest at position 0.

:NOTE: For clarification: Line Of Sight is not factored. If you want to use this API with LOS restrictions, see [[4rpl:commands:getterrainlos|GetTerrainLOS]].\\
:WARNING: Spores, Blobs, etc, aren't special targets and will not be detected.
            
===== Examples =====
<code 4rpl>
GetSpecialTargets(V4(1 1 0 0) GetUnitPosition(self) GetUnitRange(self) false) ->units
</code>

<=[[4rpl:start| Index]]