Skip to main content
Documentation

Contact support

Docs

3DS Max bridge

The 3DS Max bridge ships as a Python package plus MAXScript startup and MacroScripts. Official paths are Windows-oriented. Below: Asset Hub install, then a full manual copy list (scripts, startup, UI macros).

Placeholder — 3DS Max with Korvix3D in Customize User Interface.

Platform: Manual paths below use %LOCALAPPDATA%\Autodesk\3dsMax\…. If you use macOS/Linux for other DCCs, this bridge is documented for the Windows 3DS Max layout.

Before you install

  • Get the bridge from the Download page (ZIP) or via Asset Hub → Bridges.
  • 3DS Max 2024+ builds are typical; match the package to your Max year.
  • Set Korvix3D Directory in Asset Hub so the bridge can sync with the shared folder.

Install from Asset Hub (recommended)

  1. Open Asset Hub → Bridges → 3DS Max → Install.
  2. Pick the Max version when prompted (installer copies scripts, startup, and macros when using the bundled installer).
  3. Restart 3DS Max and check the MAXScript Listener (F11) for a successful load line.

Manual installation (Windows)

If you extracted the ZIP yourself, you will copy three kinds of files: the Python plugin folder, a startup script, and MacroScript definitions. Replace {version} with your Max version (e.g. 2025, 2024).

1. Base paths

Everything lives under your per-version user profile:

%LOCALAPPDATA%\Autodesk\3dsMax\{version}\ENU\

Example for 2024: C:\Users\<You>\AppData\Local\Autodesk\3dsMax\2024\ENU\

Placeholder — ENU folder in Explorer.

2. Copy the plugin folder

Copy the entire korvix3d_3dsmax folder into:

…\3dsMax\{version}\ENU\scripts\korvix3d_3dsmax\

Keep the bundled libs directory if present — it avoids separate pip installs.

Placeholder — scripts\\korvix3d_3dsmax in place.

3. Startup script

Copy Korvix3D-startup.ms from the package (under startup in the ZIP) to:

…\ENU\scripts\startup\Korvix3D-startup.ms

This runs when Max starts and wires Python paths. If scripts\startup does not exist, create it.

Placeholder — startup folder with Korvix3D-startup.ms.

4. MacroScripts (Customize UI)

Copy all .mcr files from the package's macroscripts folder to:

…\ENU\ui\macroscripts\

After restart, Customize → Customize User Interface should show a Korvix3D category so you can drag the bridge button to a toolbar or menu.

Placeholder — Customize UI with Korvix3D category.

5. Dependencies (only if libs missing)

Prefer the bundled libs folder. If you must install manually, use 3DS Max's Python executable, for example:

"C:\Program Files\Autodesk\3ds Max 2024\Python37\python.exe" -m pip install requests watchdog

Adjust the year in the path to match your installation.

6. Restart and verify

  1. Close all 3DS Max instances and open Max again.
  2. Press F11 (MAXScript Listener) and look for a Korvix3D load success message.
  3. Run: macros.run "Korvix3D" "Korvix3D_Bridge" (exact macro names may match your .mcr files).

Add the bridge to your UI

  1. Press Y or Customize → Customize User Interface.
  2. Open the Toolbars (or Menus) tab → category Korvix3D.
  3. Drag Korvix3D (bridge) onto a toolbar, then Save.

Troubleshooting (manual install)

  • No Korvix3D in Customize UI: MacroScripts missing from ui\macroscripts — recopy .mcr files and fully restart Max.
  • No startup message: Confirm Korvix3D-startup.ms is under scripts\startup.
  • Python import errors: Restore korvix3d_3dsmax\libs or pip-install requests/watchdog into Max's Python.

Contact support with Max version, Windows build, and Listener output.