MirzaLinkManager — Documentation
3ds Max Plugin · MaxScript

MirzaLinkManager

Live links between CAD/BIM models and 3ds Max scenes — update your design in Archicad, Revit, Rhino, SketchUp, or AutoCAD without losing the work done in Max. Materials, modifiers, properties, and plugin references like Forest Pack are preserved.

What is Mz Link Manager?

Mz Link Manager is a 3ds Max plugin for archviz artists who work alongside a CAD/BIM-driven pipeline. Each linked file becomes a MzModelLink node in your scene — a parent helper that owns the imported meshes. When the architect re-exports, you re-import through the plugin and your scene work is transferred onto the rebuilt geometry, matching meshes by material name.

You keep your archviz work. The geometry stays in sync with the architect's design.

💡
Material names are the bridge. Mz Link Manager identifies child meshes by their material name on update. Consistent material naming in your source CAD/BIM file is the single most important habit for clean updates.

Quick Start

From install to your first updated link in five steps.

1

Install & launch

Drag the .mzp package onto 3ds Max. Open the plugin from Tools menu → Mirza tools → Mz Link Manager.

2

Open the Create panel

The Mz Link Manager floater has four rollouts: Create, Manage, Material converter for Revit, and Help. Open Create.

3

Configure the import

Pick your BIM/CAD Software (Archicad, Revit, Rhino, Sketchup, Autocad, Other). Choose Meshes by → Material for archviz work. Leave Clean edges, Autosmooth, and Weld ticked.

A short export tip appears below the dropdowns when you change software — the format and settings to use in the source application.
4

Create the link

Click Create link... and browse to the exported file. The plugin applies the right import preset, splits geometry by material, runs the cleanup steps, and parents everything under a new MzModelLink node. A confirmation dialog shows the duration.

5

Update later

Open the Manage rollout. Rows turn yellow when the source file is newer than the last update. Click Update all outdated, or select rows and click Update selection. Your materials, modifiers, properties, and selection sets are transferred onto the new geometry.

Interface Tour

Everything happens in a single floater called Mz Link Manager, opened from the Tools menu. The floater stacks four rollouts vertically.

Create rollout

For building a new link from a CAD/BIM file. Holds the software picker, merge mode, geometry cleanup options, and the Create link... button.

Manage rollout

For working with all links in the current scene. The centerpiece is a table listing every MzModelLink with its source file, software, last update, and per-link options. Below it sit the update, clone, merge, and import-into buttons, plus the reference system.

Material converter for Revit

A one-click fix that converts Autodesk materials and Autodesk maps (the kind Revit brings in via FBX) into native 3ds Max Standard or Physical materials.

Help

Hyperlinks to the Mirzasoft contact page, bug report form, and review page.

Per-link Modify panel

Each MzModelLink node also has its own UI in the Modify panel — a Globals rollout (icon size, open editor) and a Settings rollout that exposes the same import settings used at create time. The Update button there lights up when the link is outdated.

Create Panel
Build a new link from a CAD/BIM file

The Create panel turns a CAD/BIM export into a Mirza link. The settings you choose are saved on the new link object and reused for every future update — so it pays to pick them deliberately the first time.

The flow is: pick the source software, pick the merge mode, set the geometry cleanup options, then browse to the file. Everything else is automatic.

🏗 Per-software presets Each source application has its own tuned import preset for OBJ, FBX, RVT, DWG, and SKP. No manual configuration.
🧩 Three merge modes Split geometry by Material, Layer, or ObjectID. Material is the default and what the reference system matches on.
Geometry cleanup Clean edges, autosmooth, and weld run automatically on every imported mesh. Toggle each in the panel.
Use reference Pre-populate the new link with materials and modifiers from an existing reference link in the scene or in another file.

Typical workflow

🏗
Pick source software
🧩
Set merge mode & options
📂
Browse to the file
Link created

Settings reference

SettingDescription
BIM/CAD SoftwareArchicad · Revit · Rhino · Sketchup · Autocad · Other
Meshes byMaterial (default) · Layer · ObjectID (Archicad/Revit only)
Unitsm · cm · mm · inches · feet — used for AutoCAD only
Clean edgesMarks edges visible/invisible by angle — hides triangulation on flat surfaces
AutosmoothGenerates smoothing groups across edges below threshold
WeldWelds coincident vertices within tolerance
Explode Generic (Revit)Splits Revit's catch-all Autodesk Generic material by RGB color
Use referenceApply materials/modifiers/properties from a reference link immediately after import
Pick Material whenever you can. The reference and update systems both match meshes by material name. If you choose Layer or ObjectID, those features only work where names happen to coincide.
Manage Panel
Update, clone, merge, and reference all links in the scene

The Manage panel is where you work with the links you've already created. Its central control is a table listing every MzModelLink in the scene; below the table sit the bulk operations.

The table shows ten columns: Name, Path, Format, Software, Last update, Edge, Smooth, Weld, Units, and Link by. Edit the name in place, toggle the geometry checkboxes inline, or double-click the Path cell to re-link to a different file.

building_v3.fbx · Revit · 2024-08-12 — outdated
furniture.obj · Archicad · 2026-05-20 — up to date
Update outdated Yellow rows are outdated. Update all of them in one click, or just the selected rows.
Clone Duplicate a link with its children, materials, and modifiers. Child mesh names are preserved.
Import into… Add meshes from a different file into an existing link without disturbing existing children.
⊕⊕ Merge selected Combine two links into one. Meshes with matching names collapse together.

Typical workflow

Refresh the table
🟡
Find yellow rows
Select & update
Work continues

Operations reference

ButtonSelectionAction
RefreshRe-checks file modification dates and re-paints outdated rows
Update all outdatedUpdates every yellow row in the table
Update selection1+ rowsUpdates only the selected rows
Cloneexactly 1Duplicates the link and its children
Import into…exactly 1Browses a file and adds its meshes to the selected link
Merge selectedexactly 2Merges the second selected link into the first
Apply reference1+ rowsApplies the chosen reference to the selected links
Save before updating. Updates run with undo disabled and scene redraw suspended for speed. A saved scene is the only reliable way back if something goes wrong.

Panel Comparison

The Create and Manage panels work on the same MzModelLink objects but at different points in their lifecycle. Create owns the birth of a link; Manage owns everything that happens to it afterward.

Create Panel
WhenBirth — first time importing a file
InputBrowse to a CAD/BIM file on disk
OutputA new MzModelLink node in the scene
ScopeOne file per click of Create link
SavesAll import settings onto the link object
Manage Panel
WhenOngoing — every revision after
InputExisting links + their source files
OutputRebuilt geometry on the same link nodes
ScopeOne link, multiple links, or all outdated
ReadsSaved settings + source file
BothUse the reference system for materials, modifiers, properties
BothHonor the same per-software import presets
BothMatch meshes by material name
BothRun with undo off and scene redraw suspended
BothBuild a selection set named after the link

Supported Software

Mz Link Manager ships with tuned import presets for five source applications. Each card below shows the recommended export format and the quickest setup tip.

Archicad
.fbx .obj .skp

Export to FBX (from Archicad 27) or OBJ at 1000 mm with model normals. Splits by material, layer, or ObjectID.

Revit
.fbx .rvt .dwg

FBX is the cleanest path. Uses 3ds Max's File Link Manager with a "Combine by Revit Material / Category / Family Type" preset.

Rhino
.obj .fbx .dwg

Export OBJ as Polygon Mesh in meters. The plugin strips Rhino's object-name prefix from sub-materials.

SketchUp
.obj .skp

OBJ in meters with model units, don't change YZ axis. SKP imports work in 3ds Max 2020+ via the new importer.

AutoCAD
.dwg .dxf

Set Units in the Create panel to match the DWG's drawing units. Splits by material (collapsing layers) or by layer.

Other
any

Generic preset, no per-software cleanup. Use this for one-off imports from anything not in the list above.

💡
The export tip strip: when you pick a software in the Create panel, a short tip below the dropdowns reminds you of the right format and settings to use in the source application. Worth a glance every time.

Reference System

A reference link is a Mirza link in your scene (or in an external .max file) that holds the materials, modifiers, and properties you want to apply to other links. The reference system pushes those properties from the reference onto target links, matching meshes by material name.

When to use it

Three patterns come up most often:

ScenarioSetup
New revision of a projectPrevious revision's link becomes the reference for the new one
Variations of one buildingOne master-shaded link holds final materials; variations inherit from it
Shader library across projectsA dedicated .max file of reference links, loaded via Load from external file

What gets transferred

Tick what to apply in the Reference group of the Manage panel:

PropertyDefaultNotes
MaterialsOnThe full 3ds Max material assigned to each matching mesh
ModifiersOnThe full modifier stack — including Forest Pack and other plugin-dependent modifiers
PropertiesOnObject properties: visibility, render flags, motion blur, etc.
Selection setsOffMembership in named selection sets
LayersDeliberately excluded; protects your scene's layer structure

External file references

Tick Load from external file and browse to another .max file. The dropdown lists every MzModelLink found in it. On apply, the chosen link is temporarily merged into the scene, used as a source, then removed.

The shader library pattern: keep a single .max file containing only Mirza links with finished materials. Use it as the Load from external file reference for every new project — your shader library is decoupled from any specific scene.

Updates & Outdated Detection

When the source file's modification date is newer than the link's stored last-update timestamp, the row turns yellow in the Manage table. Click Refresh to recheck after a file change.

Three update flows

Normal update Delete old children, re-import the file, transfer materials/modifiers/properties by material name. Use this for routine updates.
Import into… Add meshes from a different file into the existing link, without touching existing children. Use this for partial exports (a new wing, an annex).
↻+ Update with reference Pull materials/modifiers from another link during the update, instead of from the link's own previous state. Use this for revisions.
Clone before risk Not strictly an update — but a safety copy before a risky update. The clone preserves the previous state and can serve as a reference if the update goes wrong.

What's preserved

PropertyPreserved by update?
MaterialsYes — by material name match
Modifier stackYes — including plugin modifiers (Forest Pack, RailClone, etc.)
Object propertiesYes — visibility, render flags, motion blur
Layer assignmentsYes
Selection set membershipYes
Link transform (position/rotation)Yes — temporarily reset to origin during import, restored after
Plugins must be loaded. If a child has a Forest Pack scatter or any other plugin-dependent modifier, that plugin must be loaded in 3ds Max for the modifier to transfer. Missing plugins = silently lost modifiers on update.
💡
Delete protection. Mz Link Manager keeps a persistent list of links and their children. If you delete a link node by accident, the plugin detects this on the next scene action and asks whether to recreate it. The protection list is saved with the scene, so the dialog appears even after saving and reopening.

Material Converter for Revit

Revit FBX imports bring in Autodesk_Material objects and Autodesk_Map texture nodes. These often don't render correctly in V-Ray, Corona, or Arnold. The Material converter rollout replaces them with native 3ds Max Standard or Physical materials and their map equivalents.

Map conversions

Autodesk map typeConverted to
UnifiedBitmap (bitmap)Bitmap
NoiseNoise
SpeckleSpeckle
TileBricks (approximate)
Other / unrecognizedColor map (if Replace unsuccessfully converted is on)

Settings

SettingDescription
Convert toStandard (for V-Ray/Corona) or Physical (for Arnold and modern PBR)
Replace unsuccessfully converted mapsSubstitute a solid color map carrying the original tint, when conversion fails
Select objects with problem mapsAfter conversion, select meshes that use unconvertible maps so you can review them
Convert once, then shade. The cleanest workflow is: update the Revit link → run the converter → continue your shading work on native materials. Converting after you've already shaded means redoing assignments.
One-way conversion. The Autodesk material is replaced in place — only Ctrl+Z reverses it. Clone the link first if you want to keep the originals around.

Troubleshooting

The plugin isn't in the Tools menu

The menu is created on startup. If you installed while 3ds Max was running, restart Max. If it still doesn't appear, verify the app/ folder is at %LOCALAPPDATA%\Autodesk\ApplicationPlugins\ and that PackageContents.xml is at its root.

Materials and modifiers are lost after an update

The transfer matches old children to new children by material name. If material names changed in the source file (or you renamed materials in 3ds Max), the match fails silently. Before risky updates, clone the link — the clone preserves the previous state and can serve as a reference after the update.

Forest Pack scatter disappears after update

Plugin-dependent modifiers only transfer when the plugin is loaded in 3ds Max at update time. Confirm Forest Pack (or RailClone, MultiScatter, etc.) is loaded before clicking Update.

"It seems like a Mirza Link was deleted, recreate it?"

This is the delete protection talking. The plugin detected that a link node was deleted while its children are still in the scene. Choose Yes to restore the link with its meshes; No to remove it from the protection list.

Update appears frozen

Large Revit FBX/RVT files (500 MB+) can take several minutes. The viewport doesn't redraw during import — this is intentional and faster. Check the status-line progress bar. If there's truly no progress for 5+ minutes, look at the MAXScript listener for errors.

Apply reference doesn't transfer anything

Check that material names in the reference match those in the target. concrete_grey and concrete_gray (US spelling) are different to the matcher. Either rename the materials, or rename the meshes manually before applying.

💡
Still stuck? Report a bug with the 3ds Max version, source software, file format, and any MAXScript listener output.