addForce

1.72

GAGlobalGEGlobal

Hover & click on the images for description

Description

Description:

Applies impulse force to unit or given PhysX object at given position.

ⓘ

For more information see NVIDIA docs.

Groups:

Object Manipulation

Syntax

Syntax:

object addForce [force, position, setUnconscious]

Parameters:

object: Object - PhysX object or 2.04LALocal unit, in which case the unit must be local and will be set unconscious

force: Array - in format [x,y,z], force vector in world space; force is expressed in Newton

position: Array - in format [x,y,z], in object's relative position

since 2.18

setUnconscious: Boolean - (Optional, default true) only applies to "CAManBase" object; set to false to keep the person conscious

Return Value:

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

Additional Information

See also:

addTorque awake isAwake vectorModelToWorld vectorModelToWorldVisual selectionPosition disableBrakes brakesDisabled

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