{"name":"findCover","title":"findCover","type":"command","url":"https://community.bistudio.com/wiki/findCover","revid":377600,"updated":"2026-01-02T07:01:58Z","groups":["Broken Commands"],"status":"broken","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":"Returns the object around where the unit finds cover. The minDist, visibilityPosition and ignoreObject parameters are optional.\n\n> [!IMPORTANT]\n> Not implemented in Arma 2 and later titles (always returns objNull).","syntaxes":[{"syntax":"object findCover [position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]","params":[{"name":"object","type":"Object","type_expr":"Object"},{"name":"position","type":"Position","type_expr":"Position"},{"name":"hidePosition","type":"PositionATL","description":"getHideFrom-like position from which the unit should hide","type_expr":"PositionATL"},{"name":"maxDist","type":"Number","type_expr":"Number"},{"name":"minDist","type":"Number","optional":true,"type_expr":"Number","text":"minDist: Number - (Optional)"},{"name":"visibilityPosition","type":"Position","optional":true,"description":"used to select cover that unit can see in that direction from","type_expr":"Position","text":"visibilityPosition: Position - (Optional) used to select cover that unit can see in that direction from"},{"name":"ignoreObject","type":"Object","optional":true,"description":"ignore this object in visibility check","type_expr":"Object","text":"ignoreObject: Object - (Optional) ignore this object in visibility check"}],"returns":{"type":"Object","type_expr":"Object","description":"always objNull"},"form":"binary","left":{"text":"object"},"right":{"text":"[position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]"}}],"examples":[{"code":["unit1 findCover [ASLToATL aimPos unit2, 30];"]}],"see_also":["getHideFrom","setHideBehind","isHidden"],"notes":[{"user":"SnowSky","date":"2015-07-04T22:01:00Z","text":"An alternative function in Arma 3 might be BIS_fnc_findSafePos."}]}