Legacy Documentation: Version 5.2
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 void AddForce(Vector3 force, ForceMode mode = ForceMode.Force);
public void AddForce(Vector3 force, ForceMode mode = ForceMode.Force);

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.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public float thrust; public Rigidbody rb; void Start() { rb = GetComponent<Rigidbody>(); } void FixedUpdate() { rb.AddForce(transform.forward * thrust); } }

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

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.