{"name":"findCover","operator":null,"title":"findCover","type":"command","url":"https://community.bistudio.com/wiki/findCover","revid":377600,"updated":"2026-01-02T07:01:58Z","groups":["Broken Commands"],"status":"broken","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":"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]","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":"Position","optional":false,"default":null,"description":null,"types":["Position"],"since":null,"text":"position: Position"},{"name":"hidePosition","type":"PositionATL","optional":false,"default":null,"description":"getHideFrom-like position from which the unit should hide","types":["PositionATL"],"since":null,"text":"hidePosition: PositionATL - getHideFrom-like position from which the unit should hide"},{"name":"maxDist","type":"Number","optional":false,"default":null,"description":null,"types":["Number"],"since":null,"text":"maxDist: Number"},{"name":"minDist","type":"Number","optional":true,"default":null,"description":null,"types":["Number"],"since":null,"text":"minDist: Number - (Optional)"},{"name":"visibilityPosition","type":"Position","optional":true,"default":null,"description":"used to select cover that unit can see in that direction from","types":["Position"],"since":null,"text":"visibilityPosition: Position - (Optional) used to select cover that unit can see in that direction from"},{"name":"ignoreObject","type":"Object","optional":true,"default":null,"description":"ignore this object in visibility check","types":["Object"],"since":null,"text":"ignoreObject: Object - (Optional) ignore this object in visibility check"}],"returns":{"type":"Object","types":["Object"],"description":"always objNull","text":"Object - always objNull"},"form":"binary","operator":null,"left":{"text":"object","types":["Object"]},"right":{"text":"[position, hidePosition, maxDist, minDist, visibilityPosition, ignoreObject]","types":["Array"]}}],"examples":[{"text":"```sqf\nunit1 findCover [ASLToATL aimPos unit2, 30];\n```","code":["unit1 findCover [ASLToATL aimPos unit2, 30];"]}],"multiplayer":null,"problems":null,"aliases":[],"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."}],"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: Broken Commands","Introduced with Armed Assault version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}