doMove: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (corr. see also)
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(65 intermediate revisions by 12 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


|arg= local |= Arguments in MP
|game3= arma1
|version3= 1.00


|eff= global |= Effects in MP
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Order the given unit(s) to move to the given position (without radio messages). After reaching his destination, the unit will immediately return to formation (if in a group); or order his group to form around his new position (if a group leader). |= Description
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| unit(s) '''doMove''' position |= Syntax
|game6= tkoh
|version6= 1.00


|p1= unit(s): [[Object]] or [[Array]] |= Parameter 1
|game7= arma3
|version7= 0.50


|p2= position: [[Array]] - format [[Position]]|= Parameter 2
|arg= local


| [[Nothing]] |= Return value
|eff= global
____________________________________________________________________________________________
 
|x1= <pre>_soldier1 doMove (position officer)</pre> |= Example 1
|x2= <pre>this doMove (getMarkerPos "Marker1")</pre> |= Example 2
____________________________________________________________________________________________


| [[commandMove]], [[setDestination]], [[moveTo]], [[move]], [[addWaypoint]], [[fn_vbs_doMoveEx_(VBS2)|fn_vbs_doMoveEx]], [[setExactMovement_(VBS2)|setExactMovement (VBS2)]], [[getExactMovement_(VBS2)|getExactMovement (VBS2)]] |= See also
|gr1= Unit Control


|descr= Order the given unit(s) to move to the given position (without radio messages). Upon reaching its destination, if it is the group leader it will order the group to form around it's new position. If it is not the leader, it will immediately be ordered to return to formation by the group leader and begin moving back to the group. Use [[doStop]] to stop units returning to formation. [[moveToCompleted]] will return true when a unit issued this command reaches its destination.
|s1= unit(s) [[doMove]] position
|p1= unit(s): [[Object]] or [[Array]]
|p2= position: [[Array]] format [[Position]]
|r1= [[Nothing]]
|x1= <sqf>_soldier1 doMove (position _officer);</sqf>
|x2= <sqf>this doMove (getMarkerPos "Marker1");</sqf>
|seealso= [[commandMove]] [[setDestination]] [[moveTo]] [[move]] [[addWaypoint]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">


<!-- Note Section BEGIN -->
<dt><dt>
 
<dd class="notedate">Posted on 2008-02-09</dd>
<dd class="notedate">Posted on February 9, 2008</dd>
<dt class="note">[[User:Kronzky|Kronzky]]</dt>
<dt class="note">'''[[User:Kronzky|Kronzky]]'''</dt>
<dd class="note">
<dd class="note">
If doMove is to be used in conjunction with waypoint behavior commands (e.g. [[setSpeedMode]]), then those have to be issued ''after'' the move command to have an effect. Otherwise the move will be done with the default settings.
If doMove is to be used in conjunction with waypoint behavior commands (e.g. [[setSpeedMode]]), then those have to be issued ''after'' the move command to have an effect. Otherwise the move will be done with the default settings.
</dd>


<dd class="notedate">Posted on February 3, 2009</dd>
<dt><dt>
<dt class="note">'''[[User:General_Barron|General Barron]]'''</dt>
<dd class="notedate">Posted on 2009-02-03</dd>
<dt class="note">[[User:General_Barron|General Barron]]</dt>
<dd class="note">
<dd class="note">
If a unit is part of a group, and is not the leader, the unit will fall back into formation soon after the domove is completed. This does not happen for units that are in a group alone (because they are their own leader).
If a unit is part of a group, and is not the leader, the unit will fall back into formation soon after the domove is completed. This does not happen for units that are in a group alone (because they are their own leader).
There is no single command to get a unit to move to a position and stay there. The best way to do this is to issue a domove, then wait for the unit to reach his destination, then disable his movement AI.


There is no single command to get a unit to move to a position and stay there. The best way to do this is to issue a domove, then wait for the unit to reach his destination, then disable his movement AI. VBS2 users can use the [[fn_vbs_doMoveEx_(VBS2)|fn_vbs_doMoveEx]] function.
</dl>
</dd>


{{Note
|user= DreadedEntity
|timestamp= 20220402152226
|text= The above note is only true of units which group leader is not the player. Player-squad will remain in position until given another order (A3 v2.08.149102)
}}


<!-- Note Section END -->
{{Note
|user= DreadedEntity
|timestamp= 20220402203558
|text= If you need your script to halt until the unit has reached it's destination, [[waitUntil]] and [[moveToCompleted]] will come in handy:
<sqf>
_unit doMove _pos;
waitUntil {moveToCompleted _unit};
</sqf>
This also works with [[commandMove]]
}}


 
{{Note
</dl>
|user= Waffle SS.
 
|timestamp= 20220725062519
<h3 style="display:none">Bottom Section</h3>
|text= Seems to use PositionATL, which may be important if the destination is above a building's 1st floor.
 
}}
[[Category:Scripting Commands|DOMOVE]]
[[Category:Scripting Commands OFP 1.96|DOMOVE]]
[[Category:Scripting Commands OFP 1.46|DOMOVE]]
[[Category:Scripting Commands ArmA|DOMOVE]]
[[Category:Command_Group:_Unit_Control|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:34, 3 September 2024

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:
Order the given unit(s) to move to the given position (without radio messages). Upon reaching its destination, if it is the group leader it will order the group to form around it's new position. If it is not the leader, it will immediately be ordered to return to formation by the group leader and begin moving back to the group. Use doStop to stop units returning to formation. moveToCompleted will return true when a unit issued this command reaches its destination.
Groups:
Unit Control

Syntax

Syntax:
unit(s) doMove position
Parameters:
unit(s): Object or Array
position: Array format Position
Return Value:
Nothing

Examples

Example 1:
_soldier1 doMove (position _officer);
Example 2:
this doMove (getMarkerPos "Marker1");

Additional Information

See also:
commandMove setDestination moveTo move addWaypoint

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 2008-02-09
Kronzky
If doMove is to be used in conjunction with waypoint behavior commands (e.g. setSpeedMode), then those have to be issued after the move command to have an effect. Otherwise the move will be done with the default settings.
Posted on 2009-02-03
General Barron
If a unit is part of a group, and is not the leader, the unit will fall back into formation soon after the domove is completed. This does not happen for units that are in a group alone (because they are their own leader). There is no single command to get a unit to move to a position and stay there. The best way to do this is to issue a domove, then wait for the unit to reach his destination, then disable his movement AI.
DreadedEntity - c
Posted on Apr 02, 2022 - 15:22 (UTC)
The above note is only true of units which group leader is not the player. Player-squad will remain in position until given another order (A3 v2.08.149102)
DreadedEntity - c
Posted on Apr 02, 2022 - 20:35 (UTC)
If you need your script to halt until the unit has reached it's destination, waitUntil and moveToCompleted will come in handy:
_unit doMove _pos; waitUntil {moveToCompleted _unit};
This also works with commandMove
Waffle SS. - c
Posted on Jul 25, 2022 - 06:25 (UTC)
Seems to use PositionATL, which may be important if the destination is above a building's 1st floor.
Retrieved from "https://community.bistudio.com/wiki?title=doMove&oldid=369214"