moveOut

Description

Moves the soldier out of the vehicle.

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 action "Eject") - unlike doGetOut, commandGetOut. It will work for player entities regardless though
• Still executes when the vehicle is moving/flying (same as action "Eject") - unlike doGetOut, commandGetOut
• Without vehicle's position's get out animation - unlike action eject, doGetOut, commandGetOut
• Immediately - unlike action eject, doGetOut, commandGetOut
• Works also on dead units (same as action "Eject" (but one after another)) - unlike doGetOut, commandGetOut
• Does not work for UAV crew
• Does not work for remoteControlled units
• Works on unconscious (same as action "Eject" (but one after another)) - unlike doGetOut, commandGetOut (unless AI under player command)

Syntax

Syntax 1

moveOut soldier

Parameters:

• soldier: Object - unit (only a living unit before Arma 3 v2.06)

Returns: Nothing

Syntax 2

since arma3 2.06

soldier moveOut vehicle

Parameters:

• soldier: Object - unit
• vehicle: Object - vehicle could be objNull, in this case the command is identical to the main syntax.

Returns: 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")
    ]
];

See also

Arma 3: Actions · doGetOut · commandGetOut · leaveVehicle · moveInDriver · moveInGunner · moveInCommander · moveInTurret · moveInCargo · isTurnedOut