GameObject.FindGameObjectsWithTag Manual     Reference     Scripting  
Scripting > Runtime Classes > GameObject

static function FindGameObjectsWithTag (tag : string) : GameObject[]


Returns a list of active GameObjects tagged tag. Returns null if no GameObject was found.

Tags must be declared in the tag manager before using them.

// Instantiates respawnPrefab at the location
// of all game objects tagged "Respawn".
var respawnPrefab : GameObject;
var respawns = GameObject.FindGameObjectsWithTag ("Respawn");
for (var respawn in respawns)
Instantiate (respawnPrefab, respawn.position, respawn.rotation);
// Print the name of the closest enemy

// Find the name of the closest enemy
function FindClosestEnemy () : GameObject {
// Find all game objects with tag Enemy
var gos : GameObject[];
gos = GameObject.FindGameObjectsWithTag("Enemy");
var closest : GameObject;
var distance = Mathf.Infinity;
var position = transform.position;
// Iterate through them and find the closest one
for (var go : GameObject in gos) {
var diff = (go.transform.position - position);
var curDistance = diff.sqrMagnitude;
if (curDistance < distance) {
closest = go;
distance = curDistance;
return closest;