Legacy Documentation: Version 5.0
Language: English
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Rigidbody.AddForce

Switch to Manual
public function AddForce(force: Vector3, mode: ForceMode = ForceMode.Force): void;

Parameters

forceIn world coordinate system.

Description

Adds a force to the rigidbody.

Force can be applied only to an active rigidbody. If a GameObject is inactive, AddForce has no effect.

See Also: AddForceAtPosition, AddRelativeForce, AddTorque.

// Add a thrust force to push an object in its current forward
// direction (to simulate a rocket motor, say).
var thrust: float;
var rb: Rigidbody;

function Start() { rb = GetComponent.<Rigidbody>(); }

function FixedUpdate () { rb.AddForce(transform.forward * thrust); }

public function AddForce(x: float, y: float, z: float, mode: ForceMode = ForceMode.Force): void;

Parameters

xSize of force along the world x-axis.
ySize of force along the world y-axis.
zSize of force along the world z-axis.

Description

Adds a force to the rigidbody.

Force can be applied only to an active rigidbody. If a GameObject is inactive, AddForce has no effect.