# PhysicsCoreSettings2D

> PhysicsCore Settings Asset. This contains all the global physics options along with the default values for the following definitions: PhysicsWorldDefinition PhysicsBodyDefinition PhysicsShapeDefinition PhysicsChainDefinition PhysicsDistanceJointDefinition PhysicsFixedJointDefinition PhysicsHingeJointDefinition PhysicsRelativeJointDefinition PhysicsSliderJointDefinition PhysicsWheelJointDefinition

## Definition

* **Type:** Class
* **Namespace:** [Unity.U2D.Physics](/engine/6000.5/script-reference/unity/u2d/physics.md)
* **Assembly:** UnityEngine.PhysicsCore2DModule
* **Inherits from:** [ScriptableObject](/engine/6000.5/script-reference/unityengine/scriptableobject.md)

```csharp
public sealed class PhysicsCoreSettings2D : ScriptableObject
```

## Properties

| Property                                                                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [alwaysDrawWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/alwaysdrawworlds.md)                             | Controls if worlds are always drawn independent of whether rendering is currently active or not as specified by \_renderingMode. When true, world drawing is always active and a [PhysicsEvents.WorldDrawResults](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/worlddrawresults.md) event is produced containing the [PhysicsWorld.DrawResults](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawresults.md). When false, world drawing only occurs depending on the \_renderingMode setting.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [concurrentSimulations](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/concurrentsimulations.md)                   | Controls how many simulations can be started in parallel. Each one is started on its own worker and acts as its own main-thread. Workers should ideally be left free for the solver otherwise it may degrade solving performance. The actual quantity of workers used will always be capped to those available on the current device.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| [contactFilterGroupMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/contactfiltergroupmode.md)                 | The mode used for the [PhysicsShape.ContactFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactfilter.md) when determining if two [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) can contact. See [PhysicsShape.ContactFilterGroupMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactfiltergroupmode.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [contactFilterMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/contactfiltermode.md)                           | The mode used for the [PhysicsShape.ContactFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactfilter.md) when determining if two [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) can contact. See [PhysicsShape.ContactFilterMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactfiltermode.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| [disableSimulation](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/disablesimulation.md)                           | Controls the simulation of any [PhysicsWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld.md) temporarily removing simulation overhead. When true, no automatic simulation will occur. When false, normal operation occurs with automatic simulation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/lengthunitspermeter.md)                       | The internal length units per meter.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| [maximumWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/maximumworlds.md)                                   | Get/Set the maximum number of worlds that can be created. The larger the number of worlds, the more memory that is initially allocated so care must be taken. Setting this value to one will reduce start-up memory usage to a minimum but will not allow any additional worlds to be created. The maximum value must be in the range of 1 to 1024. Any change will only be handled by Exiting Play mode in the Editor or restarting the player build.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [physicsBodyDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsbodydefinition.md)                   | Get/Set the [PhysicsBodyDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsbodydefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [physicsChainDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicschaindefinition.md)                 | Get/Set the [PhysicsChainDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicschaindefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [physicsDistanceJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsdistancejointdefinition.md) | Get/Set the [PhysicsDistanceJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsdistancejointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [physicsFixedJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsfixedjointdefinition.md)       | Get/Set the [PhysicsFixedJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsfixedjointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [physicsHingeJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicshingejointdefinition.md)       | Get/Set the [PhysicsHingeJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicshingejointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [physicsLayerNames](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicslayernames.md)                           | A set of 64 "layer" names associated with each bit in a [PhysicsMask](/engine/6000.5/script-reference/unity/u2d/physics/physicsmask.md) when used for contacts and queries.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [physicsRelativeJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsrelativejointdefinition.md) | Get/Set the [PhysicsRelativeJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsrelativejointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [physicsShapeDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsshapedefinition.md)                 | Get/Set the [PhysicsShapeDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsshapedefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [physicsSliderJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicssliderjointdefinition.md)     | Get/Set the [PhysicsSliderJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicssliderjointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| [physicsWheelJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicswheeljointdefinition.md)       | Get/Set the [PhysicsWheelJointDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicswheeljointdefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [physicsWorldDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicsworlddefinition.md)                 | Get/Set the [PhysicsWorldDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsworlddefinition.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| [renderingMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/renderingmode.md)                                   | Controls drawing and rendering is allowed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| [transformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/transformchangemode.md)                       | Defines when changes to [Transform](/engine/6000.5/script-reference/unityengine/transform.md) that has are registered with [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md) are called. NOTE: In the Unity Editor when not in Play Mode, Transform change callbacks are always and only sent at the start of the frame for authoring purposes. See [PhysicsWorld.TransformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformchangemode.md).                                                                                                                                                                                                                                                                                                                                                                                                                |
| [usePhysicsLayers](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/usephysicslayers.md)                             | Controls if the physics 64-bit layers are used based upon [\_physicsLayerNames](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicslayernames.md) or if not, the standard 32-bit layers based upon [LayerMask](/engine/6000.5/script-reference/unityengine/layermask.md). If a [PhysicsCoreSettings2D](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d.md) asset is assigned then the physics layers ([\_physicsLayerNames](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicslayernames.md)) will be used if [\_usePhysicsLayers](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/usephysicslayers.md) is also active. If no [PhysicsCoreSettings2D](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d.md) asset is assigned then the global layers (See [LayerMask](/engine/6000.5/script-reference/unityengine/layermask.md)) will be used. |

## Inheritance

**Inherited Members:**

* [ScriptableObject.CreateInstance(string)](/engine/6000.5/script-reference/unityengine/scriptableobject/createinstance.md#createinstance\(string\))
* [ScriptableObject.CreateInstance(Type)](/engine/6000.5/script-reference/unityengine/scriptableobject/createinstance.md#createinstance\(type\))
* [ScriptableObject.CreateInstance\<T>()](/engine/6000.5/script-reference/unityengine/scriptableobject/createinstance.md)
* [Object.GetEntityId()](/engine/6000.5/script-reference/unityengine/object/getentityid.md)
* [Object.GetHashCode()](/engine/6000.5/script-reference/unityengine/object/gethashcode.md)
* [Object.InstantiateAsync\<T>(T)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Transform, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, Vector3, Quaternion, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Transform, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, InstantiateParameters, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, InstantiateParameters, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, Vector3, Quaternion, InstantiateParameters, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.InstantiateAsync\<T>(T, int, ReadOnlySpan\<Vector3>, ReadOnlySpan\<Quaternion>, InstantiateParameters, CancellationToken)](/engine/6000.5/script-reference/unityengine/object/instantiateasync.md)
* [Object.Instantiate(Object, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion\))
* [Object.Instantiate(Object, Vector3, Quaternion, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object-vector3-quaternion-transform\))
* [Object.Instantiate(Object)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object\))
* [Object.Instantiate(Object, Scene)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object-scene\))
* [Object.Instantiate\<T>(T, InstantiateParameters)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion, InstantiateParameters)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate(Object, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform\))
* [Object.Instantiate(Object, Transform, bool)](/engine/6000.5/script-reference/unityengine/object/instantiate.md#instantiate\(object-transform-bool\))
* [Object.Instantiate\<T>(T)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Vector3, Quaternion, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Transform)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Instantiate\<T>(T, Transform, bool)](/engine/6000.5/script-reference/unityengine/object/instantiate.md)
* [Object.Destroy(Object, float)](/engine/6000.5/script-reference/unityengine/object/destroy.md)
* [Object.DestroyImmediate(Object, bool)](/engine/6000.5/script-reference/unityengine/object/destroyimmediate.md)
* [Object.FindObjectsByType(Type)](/engine/6000.5/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type\))
* [Object.FindObjectsByType(Type, FindObjectsInactive)](/engine/6000.5/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytype\(type-findobjectsinactive\))
* [Object.DontDestroyOnLoad(Object)](/engine/6000.5/script-reference/unityengine/object/dontdestroyonload.md)
* [Object.FindAnyObjectByType\<T>()](/engine/6000.5/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(\))
* [Object.FindAnyObjectByType\<T>(FindObjectsInactive)](/engine/6000.5/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytypet\(findobjectsinactive\))
* [Object.FindObjectsByType\<T>()](/engine/6000.5/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(\))
* [Object.FindObjectsByType\<T>(FindObjectsInactive)](/engine/6000.5/script-reference/unityengine/object/findobjectsbytype.md#findobjectsbytypet\(findobjectsinactive\))
* [Object.FindAnyObjectByType(Type)](/engine/6000.5/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type\))
* [Object.FindAnyObjectByType(Type, FindObjectsInactive)](/engine/6000.5/script-reference/unityengine/object/findanyobjectbytype.md#findanyobjectbytype\(type-findobjectsinactive\))
* [Object.ToString()](/engine/6000.5/script-reference/unityengine/object/tostring.md)
* [Object.name](/engine/6000.5/script-reference/unityengine/object/name.md)
* [Object.hideFlags](/engine/6000.5/script-reference/unityengine/object/hideflags.md)

### Operators

| Operator                                                                           | Description                                                             |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| [operator ==](/engine/6000.5/script-reference/unityengine/object/op-equality.md)   | Compares two object references to see if they refer to the same object. |
| [bool](/engine/6000.5/script-reference/unityengine/object/op-implicit.md)          | Determines whether the object exists.                                   |
| [operator !=](/engine/6000.5/script-reference/unityengine/object/op-inequality.md) | Compares if two objects refer to a different object.                    |
