{"name":"getSuppression","operator":null,"title":"getSuppression","type":"command","url":"https://community.bistudio.com/wiki/getSuppression","revid":320943,"updated":"2022-05-13T10:04:43Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.42"}],"since":{"game":"arma3","name":"Arma 3","version":"1.42"},"arma3_since":"1.42","branch":null,"locality":{"argument":"local","effect":null,"server_exec":false},"exec":null,"description":"Gets the suppression value for the given unit. Returns varying Number between 0 and 1, or -1 if suppression is disabled (`disableAI \"SUPPRESSION\"`) or the suppression value is not available. Suppression is not calculated for player entities and is always 0, unless it is set with setSuppression. In this case the return value is the set value. Before Arma 3 v1.92 this command could return nil.\n\n> [!IMPORTANT]\n> The unit must not be objNull, must be local and alive","syntaxes":[{"syntax":"getSuppression unit","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unit: Object"}],"returns":{"type":"Number","types":["Number"],"description":"from 0 to 1, or -1 if suppression is not available.","text":"Number - from 0 to 1, or -1 if suppression is not available."},"form":"unary","operator":null,"left":null,"right":{"text":"unit","types":["Object"]}}],"examples":[{"text":"```sqf\ngetSuppression AI_unit_1;\n```","code":["getSuppression AI_unit_1;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["setSuppression","suppressFor","disableAI","enableAI"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Arma 3 version 1.42","Scripting Commands"]}