Skip to main content

Unity bridge

The Unity bridge imports assets directly into your active Unity project's Asset folder as prefabs with materials and textures.

Placeholder — Unity Editor interface showing the imported asset prefab.

Before you install

  • Ensure you have Unity 2022.3 LTS or later.
  • In Asset Hub, set the shared folder in settings.
  • Have your Unity project open so the bridge installer can copy files into the correct directory.

Install from Asset Hub (recommended)

  1. Open Asset Hub → BridgesUnity.
  2. Click Install and select your Unity project root folder (the folder containing the Assets and ProjectSettings directories).
  3. The installer will copy the bridge scripts and plugins into Assets/Plugins/Korvix3D/.
  4. Unity will automatically compile the scripts. You will see a Korvix3D menu option in the top toolbar.

Manual Installation

If you want to manually copy the bridge files or install via a .unitypackage:

  1. Download the Unity Bridge ZIP or .unitypackage from the Download page.
  2. In Unity, go to Assets → Import Package → Custom Package... and select the downloaded package.
  3. Ensure all items are checked and click Import.
  4. Verify that the files appear in the Assets/Plugins/Korvix3D/ directory.

Using the Unity Bridge

  1. With your Unity project open, click Korvix3D → Open Bridge from the top menu.
  2. When you export an asset from the Korvix3D desktop app targeting Unity, it will write the FBX/USD file and materials JSON directly to the shared folder.
  3. The Unity bridge will automatically detect the exported asset, copy the meshes and textures into Assets/Korvix3D_Imports/, construct the materials, and create a prefab in your scene.

Troubleshooting

  • Bridge menu item missing: Ensure the scripts are inside Assets/Plugins/Korvix3D/Editor/ and there are no compilation errors in Unity's Console window.
  • Assets not importing: Confirm that the shared folder path matching key SharedFolderPath in Windows registry matches the path configured in Asset Hub.