moveOut: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Fix description)
Line 22: Line 22:
* Works for both AI and player entities
* 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]])
* 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
* 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]]
* 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]]
* 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]]
* 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]]
* 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 UAV crew
* Does not work for [[remoteControl]]'ed units
* 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)
* Works on [[setUnconscious|unconscious]] (same as [[Arma 3: Actions#Eject|action "Eject"]] (but one after another)) - unlike [[doGetOut]], [[commandGetOut]] (unless AI under player command)
 
{{Feature | Informative | Since Arma 3 v2.05.147802 it is possible to move out dead soldiers using the alternative syntax of the command}}


|s1= [[moveOut]] soldier
|s1= [[moveOut]] soldier


|p1= soldier: [[Object]] - alive unit (or Since Arma 3 v2.05.147819 will attempt to move out dead as well)
|p1= soldier: [[Object]] - unit (only a living unit before {{GVI|arma3|2.06}})


|r1= [[Nothing]]
|r1= [[Nothing]]
Line 41: Line 39:
|s2= soldier [[moveOut]] vehicle
|s2= soldier [[moveOut]] vehicle


|p21= soldier: [[Object]] - dead or alive person
|s2since= arma3 2.06
 
|p21= soldier: [[Object]] - unit


|p22= vehicle: [[Object]] - vehicle could be [[objNull]], in this case the command is identical to the one above.
|p22= vehicle: [[Object]] - vehicle could be [[objNull]], in this case the command is identical to the main syntax.


|r2= [[Nothing]]
|r2= [[Nothing]]


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


|x2= Move out player just before he dies:<code>[[player]] [[addEventHandler]] [
|x2= Move out player just before he dies:<code>[[player]] [[addEventHandler]] [
Line 53: Line 53:
[[format]] [
[[format]] [
'[[if]] ([[switch]] (_this [[select]] 1) [[do]] {
'[[if]] ([[switch]] (_this [[select]] 1) [[do]] {
[[case]] "": {_this [[select]] 2 >= 1};
[[case]] "": { _this [[select]] 2 >= 1 };
[[case]] "head": {_this [[select]] 2 >= %1};
[[case]] "head": {_this [[select]] 2 >= %1};
[[case]] "body": {_this [[select]] 2 >= %2};
[[case]] "body": {_this [[select]] 2 >= %2};
Line 63: Line 63:
];</code>
];</code>


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



Revision as of 18:25, 13 August 2021

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" actiondoGetOutcommandGetOutleaveVehiclemoveInDrivermoveInGunnermoveInCommandermoveInTurretmoveInCargoisTurnedOut

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 August 07, 2020 - 08:53 (UTC)
.kju
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.