{"name":"findNearestEnemy","title":"findNearestEnemy","type":"command","url":"https://community.bistudio.com/wiki/findNearestEnemy","revid":377414,"updated":"2026-01-02T06:45:18Z","groups":["Object Detection"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","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","params":[{"name":"object","type":"Object","type_expr":"Object"},{"name":"position","type":"Object or PositionAGL or Position2D","type_expr":"Object | PositionAGL | Position2D"}],"returns":{"type":"Object","type_expr":"Object"},"form":"binary","left":{"text":"object"},"right":{"text":"position"}}],"examples":[{"code":["_myNearestEnemy = (units _myGroup select 0) findNearestEnemy player;"]},{"code":["_myNearestEnemy = player findNearestEnemy player;"]}],"see_also":["targets","targetsQuery","nearTargets","targetsAggregate","targetKnowledge","knowsAbout","reveal","forgetTarget","setTargetAge","getHideFrom","nearestBuilding","nearestObject","nearestObjects","nearObjects","nearestLocation","nearEntities","nearSupplies","nearestLocationWithDubbing","nearObjectsReady","nearRoads","nearestMines"]}