moveOut: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Some wiki formatting)
 
(99 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2 |= Game name
|game1= arma2
|version1= 1.00


|1.00|= Game version
|game2= arma2oa
|eff= global|= Effects in MP
|version2= 1.50
|arg= global|= Arguments in MP
____________________________________________________________________________________________


| Moves the soldier out of vehicle. (Immediately,without animation). |= Description
|game3= tkoh
____________________________________________________________________________________________
|version3= 1.00


| '''moveOut''' soldier |= Syntax
|game4= arma3
|version4= 0.50
|eff= global
|arg= global


|p1= soldier: [[Object]]  |= PARAMETER1
|gr1= Unit Control


|p2= |= PARAMETER2
|descr= Moves the soldier out of the vehicle.
<br><br>
Notes:
* Works for both AI and player entities
* AI unit gets back in - unless is under player command or combined with other sqf commands ([[orderGetIn]] false, [[allowGetIn]] false or [[leaveVehicle]])
* Respects the vehicle's lock state (same as [[Arma 3: Actions#Eject|action "Eject"]]) - unlike [[doGetOut]], [[commandGetOut]]. It will work for [[player]] entities regardless though
* Still executes when the vehicle is moving/flying (same as [[Arma 3: Actions#Eject|action "Eject"]]) - unlike [[doGetOut]], [[commandGetOut]]
* Without vehicle's position's get out animation - unlike [[Arma 3: Actions#Eject|action eject]], [[doGetOut]], [[commandGetOut]]
* Immediately - unlike [[Arma 3: Actions#Eject|action eject]], [[doGetOut]], [[commandGetOut]]
* Works also on dead units (same as [[Arma 3: Actions#Eject|action "Eject"]] (but one after another)) - unlike [[doGetOut]], [[commandGetOut]]
* Does not work for UAV crew
* Does not work for [[remoteControl]]led units
* Works on [[setUnconscious|unconscious]] (same as [[Arma 3: Actions#Eject|action "Eject"]] (but one after another)) - unlike [[doGetOut]], [[commandGetOut]] (unless AI under player command)


|p3= |= PARAMETER3
|s1= [[moveOut]] soldier


| [[Nothing]] |= RETURNVALUE
|p1= soldier: [[Object]] - unit (only a living unit before {{GVI|arma3|2.06}})


|r1= [[Nothing]]


|x1= <code>[[if]] ([[lifeState]] _x == "UNCONSCIOUS") [[then]] {[[moveOut]] _x;};} [[forEach]] [[crew]] [[cursorTarget]];</code>|= EXAMPLE1
|s2= soldier [[moveOut]] vehicle


|s2since= arma3 2.06


|x2= Move out player just before he dies:<code>[[player]] [[addEventHandler]] [
|p21= soldier: [[Object]] - unit
"HandleDamage",
[[format]] [
'[[if]] ([[switch]] (_this [[select]] 1) [[do]] {
[[case]] "": {_this [[select]] 2 >= 1};
[[case]] "head": {_this [[select]] 2 >= %1};
[[case]] "body": {_this [[select]] 2 >= %2};
[[default]] {[[false]]};
}) [[then]] {[[moveOut]] [[player]]}',
[[getNumber]] ([[configFile]] >> "CfgFirstAid" >> "CriticalHeadHit"),
[[getNumber]] ([[configFile]] >> "CfgFirstAid" >> "CriticalBodyHit")
]
];</code>|= EXAMPLE2
____________________________________________________________________________________________


| [[action]], [[moveInDriver]], [[moveInGunner]], [[moveInCommander]], [[moveInTurret]], [[moveInCargo]], [[doGetOut]], [[commandGetOut]], [[leaveVehicle]] |= SEEALSO
|p22= vehicle: [[Object]] - vehicle could be [[objNull]], in this case the command is identical to the main syntax.


| |= MPBEHAVIOUR
|r2= [[Nothing]]
____________________________________________________________________________________________
}}


<h3 style='display:none'>Notes</h3>
|x1= <sqf>{ if (lifeState _x == "UNCONSCIOUS") then { moveOut _x } } forEach crew cursorTarget;</sqf>
<dl class='command_description'>
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on September 12, 2010
|x2= Move out player just before he dies:
<dt class="note">'''[[User:kju|kju]]'''
<sqf>
<dd class="note">
player addEventHandler [
Seems to work only for unconscious - NOT for dead bodies. [[setPos]]/ATL/ASL seems to the only working for dead bodies.
"HandleDamage",  
format [
'if (switch (_this select 1) do {
case "": { _this select 2 >= 1 };
case "head": {_this select 2 >= %1};
case "body": {_this select 2 >= %2};
default {false};
}) then {moveOut player}',
getNumber (configFile >> "CfgFirstAid" >> "CriticalHeadHit"),
getNumber (configFile >> "CfgFirstAid" >> "CriticalBodyHit")
]
];
</sqf>


|seealso= [[Arma 3: Actions#Eject|"Eject" action]] [[doGetOut]] [[commandGetOut]] [[leaveVehicle]] [[moveInDriver]] [[moveInGunner]] [[moveInCommander]] [[moveInTurret]] [[moveInCargo]] [[isTurnedOut]]
}}


<!-- Note Section END -->
{{Note
</dl>
|user= .kju
 
|timestamp= 20200807085300
<h3 style='display:none'>Bottom Section</h3>
|text= This seems no longer true in {{arma3}}:<br>
[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
''Does not work on dead [[crew]] - Use [[setPos]] family of commands to move dead units out soon after they became dead. After awhile dead unit's group becomes [[grpNull]] and it cannot be moved out at all.''
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 23:02, 16 November 2023

Hover & click on the images for description

Description

Description:
Moves the soldier out of the vehicle.

Notes:
Groups:
Unit Control

Syntax

Syntax:
moveOut soldier
Parameters:
soldier: Object - unit (only a living unit before Arma 3 logo black.png2.06)
Return Value:
Nothing

Alternative Syntax

Syntax:
soldier moveOut vehicle
Parameters:
soldier: Object - unit
vehicle: Object - vehicle could be objNull, in this case the command is identical to the main syntax.
Return Value:
Nothing

Examples

Example 1:
{ if (lifeState _x == "UNCONSCIOUS") then { moveOut _x } } forEach crew cursorTarget;
Example 2:
Move out player just before he dies:
player addEventHandler [ "HandleDamage", format [ 'if (switch (_this select 1) do { case "": { _this select 2 >= 1 }; case "head": {_this select 2 >= %1}; case "body": {_this select 2 >= %2}; default {false}; }) then {moveOut player}', getNumber (configFile >> "CfgFirstAid" >> "CriticalHeadHit"), getNumber (configFile >> "CfgFirstAid" >> "CriticalBodyHit") ] ];

Additional Information

See also:
"Eject" action doGetOut commandGetOut leaveVehicle moveInDriver moveInGunner moveInCommander moveInTurret moveInCargo isTurnedOut

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
.kju - c
Posted on Aug 07, 2020 - 08:53 (UTC)
This seems no longer true in Arma 3:
Does not work on dead crew - Use setPos family of commands to move dead units out soon after they became dead. After awhile dead unit's group becomes grpNull and it cannot be moved out at all.