prpl:getnearesttarget
This is an old revision of the document!
<- PRPL reference <- Everything Else 2
GetNearestTarget
| Arguments | Result | Notation |
|---|---|---|
| X Y Range Enemy Untargeted NotNormal NotVirtual OnlyEnemyShip | Target | [ int int float bool bool bool bool bool - PID ] |
Description
Finds the nearest target to the specified cell. If no target is found within Range cells, returns -1. If Enemy is true, returns something red, else something blue. If Untargeted is true, does not target something that a built-in unit is shooting at. If NotNormal is true, does not return ordinary particles. If NotVirtual is true, doesn't return virtual particles (Emergent, Omnis, ship hull…). OnlyEnemyShip is self-explanatory, but 
it may not change depending on Enemy.
Returned target will be a PID.
Examples
#Locate any targetable blue "thing" within 40 cells (default energy mine range) of this Core CurrentCoords 40 0 0 0 0 0 GetNearestTarget ->Target "Nearest blue target: " <-Target concat SetText #Show
prpl/getnearesttarget.1500684107.txt.gz · Last modified: 2025/02/14 14:56 (external edit)
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
