The soft is still in beta version, it will be available for download by the end of June 2026

MzAssetBrowser — Documentation
3ds Max Plugin · MaxScript

MzAssetBrowser

A unified library browser for 3D assets and Material assets (materials along with UVWMaps and other modifiers) — tag, filter, preview, and place directly from within 3ds Max.

What is MzAssetBrowser?

MzAssetBrowser is a 3ds Max plugin that gives you a dedicated panel for managing your scene file library and material library. Instead of navigating Windows Explorer and manually merging files, you build an indexed library of assets, tag them, browse previews, and place or apply them with a single double-click.

The browser operates in two distinct modes — 3D Assets and Materials — each with its own index, folder structure, and workflow. You switch between them using the mode buttons at the top of the browser.

💡
Data folder required. Before using the browser, open Settings and choose a data folder. This is where MzAssetBrowser stores its index files and preview cache — it is separate from your asset files themselves.

Quick Start

Get from zero to placing assets in five steps.

1

Install & launch

Drag'n drop the .mzp file into 3dsmax's viewport, and choose install. From the Max menu bar choose Mz Tools → MzAssetBrowser to open the browser panel.

2

Set your data folder

Click Settings (bottom of the browser). Choose a folder where MzAssetBrowser will store its database and preview images. This can be anywhere — a local SSD is recommended for fast previews. Click Save.

3

Import your first folder

In 3D Assets mode: click Import Folder and pick a folder containing your .max scene files. The browser recursively scans it and adds every file to the index. A confirmation shows how many files were found.

In Materials mode: go to Settings and set a Material Library Folder, then click Import Folder to scan it.

4

Render previews

Open the Manage Library panel (rolled up at the top of the browser), expand it, and click Render Previews. MzAssetBrowser launches a background render of all indexed files using a dedicated render scene. Thumbnails appear in the grid when done.

You can skip rendering and still browse — thumbnails will show a generic icon, and MzAssetBrowser will try to find any existing preview image near the file.
5

Place or apply

3D Assets: double-click a thumbnail to start the placement tool. Click in the viewport to place the object — it snaps to surfaces automatically. Press Shift to cycle through objects, Ctrl to rotate on Z. Right-click or press Escape to finish.

Materials: select objects in your scene first, then double-click a material thumbnail. The material is merged and applied immediately.

Interface Tour

The browser is divided into three areas:

Top bar

Mode buttons (3D Assets / Materials) sit on the left. The search box, sort order dropdown, and rating filter are to the right. The bottom strip holds Import Folder, Settings, and the Pick & Add button.

Left panel — navigation tabs

In 3D Assets mode you get four tabs: Folders, Tags, Catalog, and Smart Catalog. Materials mode omits the Folders tab (all files live in one library folder). Use the tabs to switch how you navigate your library.

Thumbnail grid

Files are displayed as thumbnail cards with the filename below. Clicking selects a card (highlight); Ctrl+click adds to the selection. Right-clicking opens the context menu with tagging, rating, hide/show, and preview actions. Page controls at the bottom navigate through large libraries.

🗂
3D Assets Mode
Browse, tag, and place scene files from a folder hierarchy

3D Assets mode is designed for libraries of .max scene files — furniture, props, vehicles, architectural elements, or any reusable geometry. Each file in the library represents a placeable object.

You can navigate this mode in two complementary ways. The Folders tab mirrors your disk hierarchy — expand and click any folder to see its files. The Tags tab shows your entire library at once, filtered by whichever tags you activate — ideal once your assets are tagged. Both views lead to the same placement action.

Automatic tagging makes the Tags tab immediately useful. In Manage Library → Tag Management, select one or more imported folders and click Auto-tag selected folders. MzAssetBrowser reads keywords from the folder path and filenames and applies them as tags — no manual work required.
🌳 Folder Tree Navigation Browse your asset hierarchy exactly as it sits on disk. Expand folders, navigate subfolders.
🖱 Interactive Placement Double-click any asset to enter placement mode. Click in any viewport to drop the object with surface snapping.
📦 Merge Modes Merge normally, merge as a group, collapse to a single mesh, or bring in as an XRef object.
🎲 Randomisation Random scale, random rotation Z, offset Z — configured in the Place Options panel. Cycles through multiple selected assets.

Typical workflow

📂
Import a folder of .max files
🏷
Tag assets by category
🔍
Filter by tag or search
🖱
Place into scene

Placement options

When placing, a Place Options panel is available (usually a small floater). Key settings:

SettingDescription
Merge modeMerge · Merge as Group · Collapsed · XRef · Proxy
Find surfaceSnaps objects to the surface under the cursor
Align to surfaceRotates the object to match the surface normal
Align toWhich part of the object touches the surface: Pivot, Bottom, Top, sides
Uniform scaleApply a fixed scale multiplier on placement
Random scaleRandom scale within a defined range
Random rotationRandom Z rotation 0–360°
Offset ZRaise or lower the object from the surface hit point
Multi-asset placement: select multiple thumbnails before double-clicking. The placement tool will cycle through your selection randomly or sequentially (configurable in Place Options). Press Shift mid-placement to cycle manually.
🎨
Materials Mode
Manage and apply materials from a centralised material library

Materials mode gives you a flat library of .max files, each containing one or more materials. The browser shows a thumbnail preview of the material — rendered on configurable shapes (sphere, cube, plane, teapot, and others) — so you can visually identify materials before applying them.

There is no folder tree in Materials mode: all library files live in a single configured folder (Material Library Folder set in Settings). You find materials through tags, the search bar, or catalogs.

🔵 Shape Previews Switch preview shape (Sphere, Cube, Plane, Teapot…) with the dropdown at the top to judge materials in context.
One-click Apply Select objects in your scene, then double-click a material thumbnail. Applied instantly — no merge dialogs.
🎨 Multi-channel Apply Apply via Diffuse channel, as Environment, or use the Material Painter for selective per-element application.
🏷 Renderer Tags Each material is tagged with its renderer (VRay, FStorm, Arnold…) so you can filter to only compatible materials.

Typical workflow

Set library folder in Settings
📥
Import library folder
🔍
Filter by renderer or tag
🎨
Apply to selection

Apply options (right-click menu)

ActionResult
Double-clickApply material to all selected objects
Apply as DiffuseAssign to the Diffuse/Base Color slot only
Apply as EnvironmentSet as scene environment map
Material PainterOpens the painter tool for element-level application
💡
Preview shape: the shape dropdown (Sphere, Cube, Plane, etc.) is saved per-session. If you work primarily with fabric materials, switch to Plane for a more representative preview.

Mode Comparison

Both modes share the same tag, catalog, and search infrastructure. The key differences are in folder structure, the action on double-click, and the preview approach.

3D Assets
NavFolder tree — mirrors disk hierarchy
ActionPlace in scene via mouse tool
PreviewRendered from asset's own camera
IndexMultiple imported folders
TabsFolders · Tags · Catalog · Smart Cat
FileOne scene = one asset
Materials
NavFlat library — one configured folder
ActionApply to selection instantly
PreviewRendered on configurable shapes
IndexSingle material library folder
TabsTags · Catalog · Smart Cat
FileOne scene = one or more materials
BothTags, catalogs, smart catalogs
BothSearch by name, tag, or renderer
BothStar ratings (1–5)
BothHide / unhide entries
BothAuto-tagging from path structure
BothSession persistence

Tags & Filtering

Tags are the primary way to find assets across large libraries. They appear as clickable chips in the left panel. Multiple tags combine as an AND filter — selecting "wood" and "dark" shows only items tagged with both.

Adding tags

Right-click any thumbnail → Edit Tags. Type tags separated by commas. Tags are lowercased and deduplicated automatically.

Automatic tagging

MzAssetBrowser can derive tags from the folder path and filename automatically — a chair in Furniture/Seating/Chairs/oak_chair.max would receive tags like furniture, seating, chairs, oak. To apply automatic tags:

Open Manage Library → Tag Management, select one or more folders in the Imported Folders list, then click Auto-tag selected folders. Check Only untagged files to skip files you have already tagged manually. You can also auto-tag just the current selection from the right-click context menu.

Renderer tags (VRay, FStorm, Arnold, Corona…) are detected automatically from the file and added as a special tag. Filter by renderer to see only compatible assets.

Catalogs & Smart Catalogs

Both modes include two additional left-panel tabs — Catalog and Smart Catalog — for organising files beyond the tag system.

📋
Catalog
Manually curated lists of favourite files

A Catalog is a saved list of assets you have hand-picked — think of it as a playlist or a mood board. Use catalogs to build project-specific collections ("Client A — Living Room props"), best-of sets ("Hero chairs"), or any grouping that doesn't map neatly to a tag.

Creating a catalog

Click the button in the Catalog tab to create a new catalog and give it a name. You can mark it as Public (shared across projects) or keep it private.

Adding files to a catalog

Select one or more thumbnails in the grid, then right-click → Add to Catalog and choose the target catalog. Files can belong to multiple catalogs simultaneously.

Browsing a catalog

Click any catalog name in the Catalog tab to display only its files in the grid. All other browser features (search, rating filter, context menu) remain available within the catalog view.

Removing files from a catalog

Select files in the catalog view, right-click → Remove from Catalog. This removes them from the list but does not delete the files from disk or the index.

Smart Catalog
Saved search filters — always shows current matching results

A Smart Catalog is a saved snapshot of your active tag filters and search. Unlike a regular Catalog, it contains no fixed list of files — instead, it re-runs the saved query against the live index every time you open it. As you add, remove, or re-tag files, the Smart Catalog results update automatically.

Creating a Smart Catalog

Activate tags and/or type a search term to get the result set you want in the grid. Then open the Smart Catalog tab and click Save current filters as Smart Catalog. Give it a name. The active tags and search text are stored.

Using a Smart Catalog

Click any Smart Catalog in the list. The browser applies the saved filters and shows all currently matching files. If you have added fifty new chairs since saving the catalog, they will appear automatically — no maintenance required.

Practical examples: a Smart Catalog called "FStorm furniture" saved with the fstorm and furniture tags active will always reflect your full FStorm furniture library, growing as you import more files.

Catalog vs Smart Catalog — when to use which

CatalogSmart Catalog
ContentsFixed, hand-picked listDynamic query result
Updates automaticallyNoYes
Best forProject sets, curated picksCategory overviews, renderer filters
Create byRight-click → Add to CatalogSet filters → Save as Smart Catalog

Placement Tool

The placement tool activates when you double-click an asset in 3D Assets mode. A ghost of the object follows the cursor in the viewport, snapping to geometry surfaces.

Controls during placement

InputAction
Left clickPlace object at cursor position
Shift (hold)Cycle to next asset in selection
Ctrl (hold)Rotate object on its own Z axis
Right click or EscEnd placement

The current object name and keyboard shortcuts are displayed as a viewport HUD in the upper-left corner of the active viewport, below the viewport label.

Place Options panel

A small floating panel (Place Options) appears when placement starts. It controls surface snapping, alignment, scale randomisation, and rotation randomisation. Settings are saved between sessions.

Note: the Place Options panel may become unresponsive while the placement tool is active — this is a MaxScript limitation. Adjust placement options before clicking Start, or use the keyboard shortcuts during placement.

Previews

Thumbnails are rendered using a dedicated render scene and cached as .jpg files in <dataFolder>/<mode>/previewCache/. Filenames use a unique ID derived from the asset path, so renaming your data folder or mode folder preserves all cached previews.

Rendering previews

Open Manage Library (rolled up at the top of the browser) and click Render Previews. A progress counter shows rendering status. The grid refreshes automatically when done.

Custom preview image

Right-click any thumbnail → Set preview image… to manually assign any image as the preview. Right-click → Remove preview to revert to the auto-rendered preview.

Preview priority

For each asset, MzAssetBrowser looks for preview images in this order:

Rendered (camera-specific) → Preview (generic cached) → FlatWireframe

For Materials mode, the shape shown corresponds to the Preview Shape dropdown (Sphere, Cube, Plane, Teapot…).

Shortcuts Reference

Browser

ActionShortcut / Control
Select thumbnailClick
Add to selectionCtrl + Click
Select all visibleCtrl + A
Open context menuRight click
Edit tagsRight click → Edit Tags
Rate assetRight click → Rate → ★–★★★★★
Place / ApplyDouble click
Next / prev pagePage buttons at bottom
SearchType in the search box (filters after a short delay)

During placement (3D Assets)

ActionKey
Place objectLeft click in viewport
Cycle to next assetHold Shift
Rotate on Z axisHold Ctrl
End placementRight click or Esc

Manage Library

ActionWhere
Import a new folderImport Folder button (bottom bar)
Scan for missing filesManage Library → Missing Files → Scan
Render all previewsManage Library → Render Previews
Auto-tag by folderManage Library → Tag Management → Auto-tag selected folders
Optimize tagsManage Library → Tag Management → Optimize all tags

MzAssetBrowser — 3ds Max Plugin · MaxScript & dotNet · Documentation generated 2026