PhysicsCore 2D project settings reference
Learn about Physics Core 2D API settings.
Read time 3 minutesLast updated 18 days ago
The following Project settings manage the global settings for the Physics Core 2D API.
Note
This documentation is about writing C# scripts using the API. To use 2D physics in the Unity Editor using components like the Rigidbody 2D component, refer to 2D physics instead.
Unity.U2D.PhysicsTo open the PhysicsCore 2D project settings window, go to Edit > Project Settings… > PhysicsCore 2D.
Note
To manage the global settings for 3D physics instead, refer to the Physics project settings reference.
Property | Description |
|---|---|
| Physics Core Settings | Assigns a set of global settings for physics objects and the physics simulation when you use the Physics Core 2D API. For more information, refer to Configure global Physics Core 2D API settings. |
Settings
The settings tab contains the settings from the PhysicsCore Settings file.
Layers
The properties in this section configure the layers Unity uses to detect collision. For more information, refer to Configure collisions between Physics Core 2D API objects.
Property | Description |
|---|---|
| Physics Layer Names | Sets the names of the 64 layers the |
Default Definitions
The properties in this section set the default values when you create a new definition object. For the individual sections, refer to the following:
General
- World definition reference
- Body definition reference
- Shape definition reference
- Chain definition reference
Joints
- Distance joint definition reference
- Fixed joint definition reference
- Hinge joint definition reference
- Relative joint definition reference
- Slider joint definition reference
- Wheel joint definition reference
Global
Property | Description |
|---|---|
| Transform Change Mode | Sets when Unity sends notifications to callbacks when the transform of a physics body changes. The options are:
|
| Contact Filter Mode | Determines when Unity reports a contact event between two shapes that have contact filters. The options are:
|
| Rendering Mode | Determines whether Unity draws a debug visualization in a built project. The options are:
|
| Maximum Worlds | Sets the maximum number of worlds that can exist at the same time. Unity always creates one physics world by default. |
| Concurrent Simulations | Sets the number of physics simulations that can run at the same time. The default is 2. |
| Length Units Per Meter | Sets the number of Unity units that correspond to one meter in the physics simulation. The default is 1. |
| Use Physics Layers | Enables the |
| Disable Simulation | Stops the simulation. You can still use the API as normal while the simulation is stopped. |
| Always Draw Worlds | Creates a |