{"name":"setUnitPos","operator":null,"title":"setUnitPos","type":"command","url":"https://community.bistudio.com/wiki/setUnitPos","revid":369297,"updated":"2024-09-03T18:42:52Z","groups":["Unit Control"],"status":"ok","replaced_by":[],"games":[{"game":"ofp","name":"Operation Flashpoint","version":"1.00"},{"game":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},{"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":"ofp","name":"Operation Flashpoint","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"local","effect":"global","server_exec":false},"exec":null,"description":"Set unit position rules. This command will not change the stance of the human player, even though it will change the output of unitPos command. To change player stance use playAction or playActionNow:\n\n```sqf\nplayer playAction \"PlayerProne\"; // DOWN\nplayer playAction \"PlayerStand\"; // UP\nplayer playAction \"PlayerCrouch\"; // MIDDLE\n```","syntaxes":[{"syntax":"unit setUnitPos mode","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unit: Object"},{"name":"mode","type":"String","optional":false,"default":null,"description":"can be:\n- \"DOWN\" - Unit goes prone and stays prone.\n- \"UP\" - Unit stands and stays standing.\n- \"MIDDLE\" - Kneel Position. Armed Assault v1.04 - Unit will not kneel if it is unarmed\n- \"AUTO\" - Unit chooses mode according to circumstances.","types":["String"],"since":null,"text":"mode: String - can be:\n- \"DOWN\" - Unit goes prone and stays prone.\n- \"UP\" - Unit stands and stays standing.\n- \"MIDDLE\" - Kneel Position. Armed Assault v1.04 - Unit will not kneel if it is unarmed\n- \"AUTO\" - Unit chooses mode according to circumstances."}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"unit","types":["Object"]},"right":{"text":"mode","types":["String"]}}],"examples":[{"text":"```sqf\n_soldier setUnitPos \"UP\";\n```","code":["_soldier setUnitPos \"UP\";"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["setUnitPosWeak","unitPos"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Unit Control","Introduced with Operation Flashpoint version 1.00","Operation Flashpoint: Elite: Scripting Commands","Operation Flashpoint: New Scripting Commands","Operation Flashpoint: Scripting Commands","Scripting Commands","Scripting Commands: Global Effect","Take On Helicopters: Scripting Commands"]}