Legacy Documentation: Version 5.1
LanguageEnglish
  • 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

force Force vector in world coordinates.

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.

Wakes up the Rigidbody by default. If the force size is zero then the Rigidbody will not be woken up.

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

x Size of force along the world x-axis.
y Size of force along the world y-axis.
z Size 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.

Wakes up the Rigidbody by default. If the force size is zero then the Rigidbody will not be woken up.