{"name":"setUnitPos","title":"setUnitPos","type":"command","url":"https://community.bistudio.com/wiki/setUnitPos","revid":379470,"updated":"2026-10-31T00:10:48Z","groups":["Unit Control"],"status":"ok","games":{"ofp":"1.00","ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofp 1.00","arma3_since":"0.50","locality":{"argument":"local","effect":"global"},"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","params":[{"name":"unit","type":"Object","type_expr":"Object"},{"name":"mode","type":"String","description":"can be:\n\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.","type_expr":"String"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"unit"},"right":{"text":"mode"}}],"examples":[{"code":["_soldier setUnitPos \"UP\";"]}],"see_also":["setUnitPosWeak","unitPos"],"notes":[{"user":"Dwarden","date":"2008-09-18T00:00:00Z","text":"Command most likely only works if run before join into group after createUnit."},{"user":".kju","date":"2011-03-11T00:00:00Z","text":"The above comment by Dwarden about 'an additional join required' is no longer true for Operation Arrowhead."},{"user":"Katulobotomia","date":"2013-09-26T00:00:00Z","text":"A unit might not always go prone when ordered to setUnitPos \"DOWN\", if the unit doesn't agree with the command. To force the unit to go prone, stop the unit from firing by setCombatMode \"BLUE\" and then order the unit to prone."}]}