Version: 2021.2
LanguageEnglish
  • C#

Physics.autoSimulation

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static bool autoSimulation;

Description

Sets whether the physics should be simulated automatically or not.

By default, physics is updated every Time.fixedDeltaTime during the play mode. It happens automatically as part of the regular game loop.

However, there are cases where being able to advance physics manually is needed. One particular example simulating physics in the edit mode. Another example could be networked physics where rewinding time back and applying all the player input is required up on receiving data from the authoritative server.

To control the physics simulation manually, disable the automatic simulation first and then use Physics.Simulate to advance time. Note that MonoBehaviour.FixedUpdate will still be called at the rate defined by Time.fixedDeltaTime, but the physics simulation will no longer be advanced automatically.

See Also: Physics.Simulate.