Legacy Documentation: Version 2017.1 (Go to current version)
  • C#
  • JS

Script language

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


Suggest a change


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.


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.



public static var defaultSolverIterations: int;
public static int defaultSolverIterations;


The defaultSolverIterations determines how accurately Rigidbody joints and collision contacts are resolved. (default 6). Must be positive.

If you are having trouble with connected Rigidbodies oscillating and behaving erratically setting a higher solver iteration count may improve their stability (but is slower).

This value is usually changed in Edit->Project Settings->Physics inspector instead of from scripts.

Note: Changing the defaultSolverIterations does not affect already created Rigidbodies. To change an existing Rigidbody please use Rigidbody.solverIterations.

See Also: Physics.defaultSolverVelocityIterations.

          Physics.defaultSolverIterations = 10;
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { void Example() { Physics.defaultSolverIterations = 10; } }

Did you find this page useful? Please give it a rating: