{"name":"findNearestEnemy","operator":null,"title":"findNearestEnemy","type":"command","url":"https://community.bistudio.com/wiki/findNearestEnemy","revid":377414,"updated":"2026-01-02T06:45:18Z","groups":["Object Detection"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Finds the nearest enemy to the specified position. Returns a null object if the object's group does not know about any enemies. This command will return nearest object that is known to the unit and is considered enemy. An empty vehicle that is part of enemy group assets (see addVehicle) can be returned as valid nearest target.","syntaxes":[{"syntax":"object findNearestEnemy position","since":null,"effect":null,"exec":null,"params":[{"name":"object","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"object: Object"},{"name":"position","type":"Object or PositionAGL or Position2D","optional":false,"default":null,"description":null,"types":["Object","PositionAGL","Position2D"],"since":null,"text":"position: Object or PositionAGL or Position2D"}],"returns":{"type":"Object","types":["Object"],"description":null,"text":"Object"},"form":"binary","operator":null,"left":{"text":"object","types":["Object"]},"right":{"text":"position","types":["Object","PositionAGL","Position2D"]}}],"examples":[{"text":"```sqf\n_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;\n```","code":["_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;"]},{"text":"```sqf\n_myNearestEnemy = player findNearestEnemy player;\n```","code":["_myNearestEnemy = player findNearestEnemy player;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["targets","targetsQuery","nearTargets","targetsAggregate","targetKnowledge","knowsAbout","reveal","forgetTarget","setTargetAge","getHideFrom","nearestBuilding","nearestObject","nearestObjects","nearObjects","nearestLocation","nearEntities","nearSupplies","nearestLocationWithDubbing","nearObjectsReady","nearRoads","nearestMines"],"notes":[],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Detection","Introduced with Armed Assault version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}