setUnitPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (middle to all caps to be consistent with the other settings.)
m (Text replacement - "<code>([^\[]+)<\/code>" to "<sqf>$1</sqf>")
(46 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
|version2= 1.00


|eff= global|= Effects in MP
|game3= arma1
|arg= local|= Arguments in MP
|version3= 1.00
____________________________________________________________________________________________


| Set unit position rules. Mode may be one of:
|game4= arma2
* '''"DOWN"''' - unit goes prone and stays prone.
|version4= 1.00
* '''"UP"''' - unit stands and stays standing.
* '''"MIDDLE"''' - Kneel Position. ArmA version 1.04 ''(Unit will not kneel if it is unarmed'')
* '''"AUTO"''' - unit chooses mode according to circumstances.


|= Description
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| unit '''setUnitPos''' mode |= Syntax
|game6= tkoh
|version6= 1.00


|p1= unit: [[Object]] |= Parameter 1
|game7= arma3
|version7= 0.50


|p2= mode: [[String]] - as above |= Parameter 2
|eff= global


| [[Nothing]] |= Return value
|arg= local
____________________________________________________________________________________________
 
|x1= <code>_soldier [[setUnitPos]] "UP";</code> |= Example 1
____________________________________________________________________________________________


| [[setUnitPosWeak]], [[unitPos]]|= See also
|gr1= Unit Control


|descr= 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]]:
<sqf>player playAction "PlayerProne"; // DOWN
player playAction "PlayerStand"; // UP
player playAction "PlayerCrouch"; // MIDDLE</sqf>
|s1= unit [[setUnitPos]] mode
|p1= unit: [[Object]]
|p2= mode: [[String]] - Can be:
* "DOWN" - Unit goes prone and stays prone.
* "UP" - Unit stands and stays standing.
* "MIDDLE" - Kneel Position. {{GVI|arma1|1.04}} - Unit will not kneel if it is unarmed
* "AUTO" - Unit chooses mode according to circumstances.
|r1= [[Nothing]]
|x1= <sqf>_soldier setUnitPos "UP";</sqf>
|seealso= [[setUnitPosWeak]] [[unitPos]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 18 September 2008‎
<dt class="note">'''[[User:Dwarden|Dwarden]]'''
<dd class="note">
Command most likely only works if run before [[join]] into group after [[createUnit array]].


<dd class="notedate">Posted on 21 October 2009
<dt><dt>
<dt class="note">'''[[User:General Barron|General Barron]]'''
<dd class="notedate">Posted on 18 September 2008‎ </dd>
<dt class="note">[[User:Dwarden|Dwarden]]</dt>
<dd class="note">
<dd class="note">
In Arma, this command does ''not'' change the stance of player units. In VBS2 after v1.30, this command ''does'' affect players (it changes their stance, but doesn't force them to stay in that stance).
Command most likely only works if run before [[join]] into group after [[createUnit]].
 
<dt><dt>
<dd class="notedate">Posted on 11 March 2011
<dd class="notedate">Posted on 11 March 2011</dd>
<dt class="note">'''[[User:kju|kju]]'''
<dt class="note">[[User:kju|kju]]</dt>
<dd class="note">
<dd class="note">
The above  comment by [[User:Dwarden|Dwarden]] about 'an additional join required' is no longer true for Operation Arrowhead.
The above  comment by [[User:Dwarden|Dwarden]] about 'an additional join required' is no longer true for Operation Arrowhead.
 
<dt><dt>
<dd class="notedate">Posted on 26 September 2013‎
<dd class="notedate">Posted on 26 September 2013‎</dd>
<dt class="note">'''[[User:Katulobotomia|Katulobotomia]]'''
<dt class="note">[[User:Katulobotomia|Katulobotomia]]</dt>
<dd class="note">
<dd class="note">
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.
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.


<!-- Note Section END -->
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|SETUNITPOS]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|SETUNITPOS]]
[[Category:Scripting Commands OFP 1.46|SETUNITPOS]]
[[Category:Scripting Commands ArmA|SETUNITPOS]]
[[Category:Scripting Commands ArmA2|SETUNITPOS]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Revision as of 21:08, 13 May 2022

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
Hover & click on the images for description

Description

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:
player playAction "PlayerProne"; // DOWN player playAction "PlayerStand"; // UP player playAction "PlayerCrouch"; // MIDDLE
Groups:
Unit Control

Syntax

Syntax:
unit setUnitPos mode
Parameters:
unit: Object
mode: String - Can be:
  • "DOWN" - Unit goes prone and stays prone.
  • "UP" - Unit stands and stays standing.
  • "MIDDLE" - Kneel Position. Logo A1 black.png1.04 - Unit will not kneel if it is unarmed
  • "AUTO" - Unit chooses mode according to circumstances.
Return Value:
Nothing

Examples

Example 1:
_soldier setUnitPos "UP";

Additional Information

See also:
setUnitPosWeak unitPos

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on 18 September 2008‎
Dwarden
Command most likely only works if run before join into group after createUnit.
Posted on 11 March 2011
kju
The above comment by Dwarden about 'an additional join required' is no longer true for Operation Arrowhead.
Posted on 26 September 2013‎
Katulobotomia
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.
Retrieved from "https://community.bistudio.com/wiki?title=setUnitPos&oldid=321309"