{"name":"addForce","title":"addForce","type":"command","url":"https://community.bistudio.com/wiki/addForce","revid":377384,"updated":"2026-01-02T06:43:53Z","groups":["PhysX"],"status":"ok","games":{"arma3":"1.72"},"since":"arma3 1.72","arma3_since":"1.72","locality":{"argument":"global","effect":"global"},"description":"Applies given force for one frame (essentially an impulse) to unit or given PhysX object at given position.\n\n> [!NOTE]\n> For more information see [NVIDIA docs](http://docs.nvidia.com/gameworks/content/gameworkslibrary/physx/apireference/files/classPxRigidBody.html).","syntaxes":[{"syntax":"object addForce [force, position, setUnconscious]","params":[{"name":"object","type":"Object","description":"PhysX object or Arma 3 v2.04Local argument unit, in which case the unit must be local and will be set unconscious","type_expr":"Object"},{"name":"force","type":"Vector3D","description":"force vector in **world** space; force is expressed in\n[newton-seconds](https://en.wikipedia.org/wiki/Newton-second) (used by [PxForceMode::eIMPULSE](https://docs.nvidia.com/gameworks/content/gameworkslibrary/physx/apireference/files/structPxForceMode.html))","type_expr":"Vector3D"},{"name":"position","type":"PositionRelative","description":"relative to object","type_expr":"PositionRelative"},{"name":"setUnconscious","type":"Boolean","optional":true,"default":"true","description":"only applies to \"CAManBase\" *object*; set to false to keep the person conscious","type_expr":"Boolean","since":"arma3 2.18","text":"setUnconscious: Boolean - (Optional, default true) only applies to \"CAManBase\" *object*; set to false to keep the person conscious"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"object"},"right":{"text":"[force, position, setUnconscious]"}}],"examples":[{"text":"Apply force [0,1000,0] defined in world space (not factoring object actual positioning) to object position [1,0,0]:\n\n```sqf\n_object addForce [[0,1000,0], [1,0,0]];\n```","code":["_object addForce [[0,1000,0], [1,0,0]];"]},{"text":"Apply force [0,1000,0] defined in model space (relative to object) to object position [1,0,0]:\n\n```sqf\n_object addForce [_object vectorModelToWorld [0,1000,0], [1,0,0]];\n```","code":["_object addForce [_object vectorModelToWorld [0,1000,0], [1,0,0]];"]},{"text":"Can be used on units since Arma 3 v2.04:\n\n```sqf\nif (local bob) then\n{\n    0 spawn\n    {\n        bob addForce [bob vectorModelToWorld [0,-200,0], bob selectionPosition \"rightfoot\"];\n        sleep 5;\n        bob setUnconscious false;\n    };\n};\n```","code":["if (local bob) then\n{\n\t0 spawn \n\t{\n\t\tbob addForce [bob vectorModelToWorld [0,-200,0], bob selectionPosition \"rightfoot\"];\n\t\tsleep 5;\n\t\tbob setUnconscious false;\n\t};\n};"]},{"code":["player addForce [player vectorModelToWorld [0, -1, 0], [0, 1, 0], false]; // not unconscious"]}],"see_also":["addTorque","awake","isAwake","vectorModelToWorld","vectorModelToWorldVisual","selectionPosition","disableBrakes","brakesDisabled"]}