<- [[.:prplreference| PRPL reference]] <- [[.:prplreference#everything_else_2|Everything Else 2]] ===== GetNearestTarget ===== ^Arguments^Result^Notation^ | X Y Range Enemy Untargeted NotNormal NotVirtual OnlyShip | 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...). OnlyShip is self-explanatory, only virtual hull particles will be found, works on both player controlled ships and allied blue ships if Enemy is FALSE. 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