addForce

Global argument
Global effect
Arma 3 v1.72

Command · Markdown · JSON · original wiki page

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