Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


GetAccumulatedForce(float)

Returns the force that the Rigidbody has accumulated before the simulation step.
Read time 1 minuteLast updated 10 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.PhysicsModule
public Vector3 GetAccumulatedForce(float step)

Parameters

step

The timestep of the next physics simulation.

Returns

Type

Description

Vector3Accumulated force expressed in ForceMode.Force.

Remarks

The accumulated force is reset during each physics simulation step.
In this example, the Rigidbody doesn't move.

Examples

using UnityEngine;public class AddForceScript : MonoBehaviour{ private Rigidbody rigidbody; void Start() { rigidbody = GetComponent<Rigidbody>(); rigidbody.useGravity = false; } private void FixedUpdate() { rigidbody.AddForce(Vector3.up * 10f, ForceMode.Impulse); var accumulatedForce = rigidbody.GetAccumulatedForce(); rigidbody.AddForce(accumulatedForce * -1f, ForceMode.Force); }}