Physics project setup

When you set up a Physics project, there are additional steps you must follow.

Unity version

Physics 1.0 is compatible with Unity version 2022.2.0b8 and later.

Recommended packages

Check the overview of the available ECS packages.

You should add the following recommended set of core packages to your project:

• com.unity.physics
• com.unity.entities
• com.unity.entities.graphics

IDE support

Entities uses the Microsoft Source Generator feature for its code generation. Because of this, you should use an IDE that's compatible with source generators. Previous IDE versions might experience slow-downs or mark valid code as errors. The following IDEs are compatible with source generators:

• Visual Studio 2022+
• Rider 2021.3.3+

Domain Reload setting

To get the best performance in your Physics project, you should disable Unity's Domain Reload setting. To do this, go to Edit > Project Settings > Editor menu, and enable the Enter Play Mode Options setting, but leave the Reload Domain and Reload Scene boxes disabled.

Note

If you disable Domain Reloads be mindful of your use of static fields and static event handlers.