Requirements#

Compatible Versions#

Version

Windows

Linux

MAC OS

USD

TBB

Python Bindings

2021.x LTS

Not tested

Not supported

Not supported

22.11

2017 U3

Python 3.10

2022.x LTS

10 and 11

Not supported

Not supported

22.11

2017 U3

Python 3.10

Unity 6 LTS

Not supported

Not supported

Not supported

N/A

N/A

N/A

Warning

The Omniverse Unity connector is not compatible with Unity 6. For Unity 6 USD support please use the Unity Native USD packages.

Unity Native USD Support#

Unity has released a bundle of packages that provide Unity’s next generation USD support. These supersede this package and are available for Unity 2023.1+. Further details can be found in the Unity forum announcement.

The new packages can be installed by name via Unity’s Package Manager.

Package name

What it does

Further Details

com.unity.importer.usd

USD Import

manual

com.unity.exporter.usd

USD Export

manual

com.unity.usd.core

USD C# SDK

manual

Note

Required Library: .NET framework 4.5+ or .NET standard 1.3+ in Unity. API Compatibility Level .NET 4.x (Net Framework) is no longer required but is still recommended because it provides better performances than .NET 2

  • To select the API Compatibility level, go to Edit > Project Settings > Player > Other Settings :

Unity Api Compatibility Level

Known Limitations#

Warning

Please read and review the known limitations before using the connector.

Note

ABI compatibility issues may arise from Boost, TBB, USD versions, and other possible libraries.

  • Unity components that are not supported will transfer as an xform in the USD Stage.

  • Exporting Unity Terrain components is not supported; we recommend using Mesh components for Terrain.

  • Live sync does not support changes to physics components or physics materials being updated Live. A re-export is required.

  • Baking Global Illumination while in Live Sync will hang the session and sometimes cause a crash.

Note

Learn more about the Unity USD packages here.