Requirements#

Supported 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#

  • 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

ABI compatibility issues may arise from Boost, TBB, USD versions, and other possible libraries. Unity 2022.3 LTS versions ship with TBB 2017; therefore, we have a custom build of USD 22.11 to use TBB 2017 for Compatibility.

Warning

Live sync and collaboration is an Alpha feature and may not function as expected in several workflows.