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.

Verifying the install

Asset Hub installs the bridge as an embedded UPM package in the project you selected. To confirm it landed:

  1. Check that Packages/com.korvix3d.bridge/ exists in your Unity project folder.
  2. In Unity, open Window → Package Manager and look for Korvix3D Bridge under In Project.
  3. If Unity was open during the install, use Assets → Refresh or restart the editor so it picks up the new package.

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.