addForce

Description

Applies given force for one frame (essentially an impulse) to unit or given PhysX object at given position.

Note
For more information see NVIDIA docs.

Syntax

object addForce [force, position, setUnconscious]

Parameters:

object: Object - PhysX object or Arma 3 v2.04Local Argument unit, in which case the unit must be local and will be set unconscious
force: Vector3D - force vector in world space; force is expressed in newton-seconds (used by PxForceMode::eIMPULSE)
position: PositionRelative - relative to object
setUnconscious: Boolean - (Optional, default true) only applies to "CAManBase" object; set to false to keep the person conscious (since arma3 2.18)

Returns: Nothing

Examples

Example 1

Apply force [0,1000,0] defined in world space (not factoring object actual positioning) to object position [1,0,0]:

_object addForce [[0,1000,0], [1,0,0]];

Example 2

Apply force [0,1000,0] defined in model space (relative to object) to object position [1,0,0]:

_object addForce [_object vectorModelToWorld [0,1000,0], [1,0,0]];

Example 3

Can be used on units since Arma 3 v2.04:

if (local bob) then
{
    0 spawn 
    {
        bob addForce [bob vectorModelToWorld [0,-200,0], bob selectionPosition "rightfoot"];
        sleep 5;
        bob setUnconscious false;
    };
};

Example 4

player addForce [player vectorModelToWorld [0, -1, 0], [0, 1, 0], false]; // not unconscious