{"name":"addForce","operator":null,"title":"addForce","type":"command","url":"https://community.bistudio.com/wiki/addForce","revid":377384,"updated":"2026-01-02T06:43:53Z","groups":["PhysX"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.72"}],"since":{"game":"arma3","name":"Arma 3","version":"1.72"},"arma3_since":"1.72","branch":null,"locality":{"argument":"global","effect":"global","server_exec":false},"exec":null,"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]","since":null,"effect":null,"exec":null,"params":[{"name":"object","type":"Object","optional":false,"default":null,"description":"PhysX object or Arma 3 v2.04Local Argument unit, in which case the unit must be local and will be set unconscious","types":["Object"],"since":null,"text":"object: Object - PhysX object or Arma 3 v2.04Local Argument unit, in which case the unit must be local and will be set unconscious"},{"name":"force","type":"Vector3D","optional":false,"default":null,"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))","types":["Vector3D"],"since":null,"text":"force: Vector3D - 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))"},{"name":"position","type":"PositionRelative","optional":false,"default":null,"description":"relative to object","types":["PositionRelative"],"since":null,"text":"position: PositionRelative - relative to object"},{"name":"setUnconscious","type":"Boolean","optional":true,"default":"true","description":"only applies to \"CAManBase\" *object*; set to false to keep the person conscious","types":["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","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"object","types":["Object"]},"right":{"text":"[force, position, setUnconscious]","types":["Array"]}}],"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};"]},{"text":"```sqf\nplayer addForce [player vectorModelToWorld [0, -1, 0], [0, 1, 0], false]; // not unconscious\n```","code":["player addForce [player vectorModelToWorld [0, -1, 0], [0, 1, 0], false]; // not unconscious"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["addTorque","awake","isAwake","vectorModelToWorld","vectorModelToWorldVisual","selectionPosition","disableBrakes","brakesDisabled"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: PhysX","Introduced with Arma 3 version 1.72","Scripting Commands","Scripting Commands: Global Effect"]}