Skip to main content
Documentation

Contact support

Docs

Maya bridge

Install the Korvix3D Maya bridge so you can browse and import assets from Korvix3D Asset Hub. Below: automatic install (Asset Hub), then a full manual walkthrough with typical folder paths.

Placeholder — replace with Maya + Korvix3D menu or shelf screenshot.

Before you install

  • Download the Maya bridge package (ZIP) from Korvix3D, or use Bridges inside Korvix3D Asset Hub.
  • Maya 2020 or later is typical; use the build that matches your Maya version if the download page lists multiple.
  • Set your shared Korvix3D folder in Asset Hub: Settings → Download Settings → Korvix3D Directory (the bridge reads this on Windows via registry).

Install from Asset Hub (recommended)

  1. Open Asset Hub and go to Bridges.
  2. Choose Maya → Install and pick the Maya year/version when asked.
  3. Restart Maya, then check the Script Editor for a successful load message (see Verification below).

Manual installation

Use this if you downloaded the ZIP from the website, or Asset Hub could not install to your Maya path. You will copy one folder into Maya's scripts directory for your Maya version, then add startup code.

1. Find your Maya scripts folder

Replace {version} with your Maya version folder (for example 2025 or 2024):

OSPath (scripts folder is the parent of korvix3d_maya)
WindowsC:\Users\<You>\Documents\maya\{version}\scripts\
macOS~/Library/Preferences/Autodesk/maya/{version}/scripts/
Linux~/maya/{version}/scripts/

If you use a custom Maya preferences location, set MAYA_APP_DIR — Maya will still resolve the versioned scripts folder under that tree.

Placeholder — Explorer/Finder showing …\maya\{version}\scripts\

2. Copy the bridge folder

From the extracted ZIP, copy the entire korvix3d_maya folder into that scripts directory. The result should look like:

…\maya\2025\scripts\
  userSetup.py          ← same folder as the package (see step 3)
  korvix3d_maya\
    __init__.py
    libs\
    …

Do not strip the libs folder — it contains bundled dependencies (e.g. requests, watchdog). Missing libs is a common cause of import errors.

Placeholder — folder tree or copy-paste step.

3. Add userSetup.py

The bundle includes a userSetup.py that loads the bridge when Maya starts. Place it in the same scripts folder as korvix3d_maya (not inside the package folder), unless your ZIP instructions say otherwise.

If you already have a userSetup.py, merge the Korvix3D lines into it instead of overwriting your file.

4. Restart Maya and verify

  1. Quit Maya completely and open it again.
  2. Open Windows → General Editors → Script Editor.
  3. Look for messages such as [Korvix3D] Plugin loaded successfully.
  4. In the menu bar you should see Korvix3D; on the shelf, a Korvix3D tab with buttons (if your build adds the shelf).
Placeholder — Script Editor with Korvix3D load messages.

Optional: load without userSetup

In the Script Editor (Python):

from korvix3d_maya import register
register()

Using the bridge

Where to find it

  • • Top menu: Korvix3D (Open Bridge, Export, Check for Imports, …)
  • • Shelf: Korvix3D tab
  • • MEL/Python command names depend on your build; see Script Editor output if menus are missing.

Import flow

  • • Start Asset Hub and ensure the shared folder is set.
  • • In Maya, start the bridge from the panel, then browse and import as documented in-app.

Troubleshooting (manual install)

  • No module named requests / watchdog: Restore the full korvix3d_maya tree including libs.
  • Nothing in menus: Wrong Maya version folder, or userSetup.py not in the same scripts level as the package.
  • Bridge can't find files: Confirm Korvix3D Directory in Asset Hub and that Asset Hub is running.

Contact support with your Maya version, OS, and any Script Editor errors.