Material ID Organizer

39 votes
Date Updated: 
Author Name: 

 - added support for Corona 7 materials
 - added support for 0 - 65535 Mateiral IDs (3ds max 2018, 2019 and up)
 - Include not used materials in scene - from SME or Material Editor
 - fixed Select / Filter form Material Editors - SME and Material Editor

 - save settings on dialog close + size and position
 - select / filter from SME and Material Editoe in one button now
 - select / filter from multiple materials in SME

 - fixed red button highlights - for selected IDs


It will let you quickly organize Mat IDs and VRay Effect ID in the scene and create MultiMatteElelemnts:

- Sort materials list by Name, ID, Type or Material Editor Slot
- Multiselect and change ID
- Reset all MatID to 0 (select all -> press 0 button)
- Select on list by ID (switch "change" -> "select" or "add to select")
- Select materials by scene objects
- Add / Delete MuliMatteElements
- Highlight Buttons of used MatIDs Vray Effect IDs


 - added support for new Corona 7 materials (owerride ID in: _CoronaPhysicalMtl, CoronaLegacyMtl, CoronaLightMtl)
 - added 'Add name prefix: #' (in Add to Render Elements window) - to make masks automatically in Pulze Post Manager

- fixed support for older 3ds max versions (2015 and lower)
- fixed update of the preview list when entering the Base name in Add to Render Elements window

- new 'A/S' button to Assign / Select
  - Left-Click  - Assign
  - Right-Click - Select
- new "Multi" (CheckButton) to enable Multi - Assign / Select option
- new 'U' Unique Assign (check-button)
- new 'R' Random Assign (check-button)
- new '-' and '+' buttons to shift selected IDs by +1 or -1
- new 'Sub-Mtls' check-button to show all sub-Materials tree (Multi/Sub-Object material, Vray Blend etc)
- new XRef-Src check-button to list sub-Mtls from XRef Materials
  - show on list with other (dark green) background color
  - collect used IDs   - for Render Elements
  - collect used names - for Render Elements
- radio buttons Include:'ME' 'SME' converted to 'ME','SME' check-buttons
- new 'Scene' check-button to include (show on list) scene materials - when off show only materials from Material Editors
- Right-Click 'ME' or 'SME' buttons to quick switch between Compact and Slave Material Editor

- new 'Materials' button to select in Material Editor
- new 'Objects' button to select objects by selected materials
- fixed: Select objects by material

- new options in Add to Render Elements:
  - Include names - include material names in element name
  - Mono mask - create black and white mask for each ID
  - Red Mask Only - create mono as red mask for each ID
  - Save Log
    - Left-Click  - to Save Log - IDs list with material names
    - Right-Click - open log file (if saved already)
    - it saves it as txt file in same location as max file
- fixed flickering while resizing / scrolling
- changed list colors (header, selection etc)
  - not-focused selection is more visible now - specially in 3ds max with Light theme

- added possibility to deactivate and move license to new workstation (Deactivate in right-click menu)
- added possibility to automatically activate license on first start without user interaction
  - solution for offices with multiple licenses - specially when script started from network location
  - it require additional 'activation-data.ini' file to be placed in same folder as .mse script file
    email= purchase email
  - to request 'activation-data.ini' file or for more info - ask me by email

 - added support for max 2018, 2019 and up - supports 0 - 65535 Mateiral IDs
 - fixed error with Corona materials
 - fixed error with VraySky and other maps loaded to Envirement slot
 - checkboxes: include materials from SME or Material Editor (to show materials not used  in scene)
 - fixed Select / Filter form material editors (SME and Material Editor)
 - save settings on dialog close
 - fixed Red button hightlight for IDs higher than 49
 - more options in Add to MultiMatte
    - start from 0 or 1 - ( include 0 toggle)
    - include empty IDs
    - add only new IDs
 - Select / Filter from multiple materials in SME
 - Select / Filter from Material Editor and SME in one button now
 - Red button highlights - for selected IDs - same as in Object ID Organizer
 - faster list load and sort
 - new toolbar icon for light and dark color scheme
 - Support for Corona G-Buffer ID and CMultiMatte
 - fixed activation error on second start
 - Filter - show materials from selected only (MatEditor, SME or Objects)
 - "A" buttons :
    - Automatic Select from... MatEditor, SME or Objects
    - Automatic Filter from... MatEditor, SME or Objects
  - added support for more than 15 MatIDs - requires EffectsChannelEx plugin from Pavel Kuznetsov
  - more ID buttons - with scroll - up to 149 ID
  - switch to use same buttons for Matetial ID Channel or VRay ID Effect Channel
  - ID spinner with Asign and Select Button
  - select material from active SME
- Add / Delete MuliMatteElements
   + custom naming
   + preview of names
   + save base name and basic settings
- focus to new selection when right click on ID buttons
- keyboard shortcuts: Ctrl+A, Ctrl+D, Ctrl+I (select all, deselect, invert selection)
- fixed Refresh All
- Multiselect and change VRay Effect ID
- Right click on buttons - select by ID, Object or MatEditor active slot
- Right click + Ctrl on on buttons - add to selection - select by ID, Object or MatEditor active slot

Coming soon:
- Preview of old MultiMatteElments ( just idea, let me know if you need it )

- mID - Material Effect Chanel ID - 0,1,2,3,4,5,.. 65535 in 2018, 2019 and up
    and up to 255 in max 2017 and lower with EffectsChannelEx by Pavel Kuznetsov
- vcOr - Vray / Corona - Override Material ID - On, Off, --
- vcID - Vray Mtl Effect ID / Corona Mtl G-Buffer ID - 0,1,2,3,4,5,.....9999
- Name - Material name (if Multisub material with submaterial naming structure - see below)
- Type - Type of material
- ME - position in Material Editor


Right click menu:
- Turn On/Off  VRay Override material effect (VrayMtl / CoronaMtl)
- Mutli/Sub Display -> 3 different ways to display Multi/Sub Materials structure
                                                1. MultiSub name -> ID# -> SubMaterial name
                                                2. < ID# > SubMaterial name -> MultiSub name
                                                3.  SubMaterial name <- ID# <- MultiSub name
- Refresh all
- About


How to Use:
- It's a script only so simply drag and drop to 3ds max.
- To change ID -> Select materials -> choose "change" mode -> Left click on ID button to apply new ID
- To select materials with specific ID -> Right click on ID button
- Add to selection -> Hold Ctrl and Right click on ID button
- To reset all to ID 0 -> select all -> Left click 0 button
- If Material Editor is open and you can check "Autoupdate Material Editor" every change, but it can slow down the process

Demo / test version does not support Multi/Sub Materials

Full version available on my web:

Let me know what you think






Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
fedemas1969's picture

very helpful

this one and the object ids script are great help when preparing the masks for post. Thanks!

todor's picture

It looks great !

It looks great !

pixamoon's picture

re: Show in Material Editor

Will fix it in new update

pixamoon's picture

re: whats the diffrence

I think the main difference is explained by script names:

Object ID Organizer - to organize Object Buffer IDs
Material ID Organizer - to organize Material Channel IDs

Both can create Render Elements to render out those IDs as RGB or Mono masks

The rest are small differences in functionality depend what is helping to work with scene materials or objects IDs

Re: adjust both at same time:
I'm not sure how you want to adjust both at the same time? Can you explain bit more?

Every object have 1 buffer ID but can have multiple Material IDs (eg with Multi-Sub Material)

Theobarbosa's picture

Whats the difference:

Whats the difference: Material ID organizer and Object ID Organizer. I need to adjust both at same time

usmansabih's picture

Show in Material Editor

The show in material editor option is not working for me on 3dsmax 2019. I am selecting only one material > right click > show in material editor, and nothing happens.

Also is there a possibility of adding the option of dragging the material from this script onto the slate material as instance or copy.

pixamoon's picture

Re: Xrefs

Yes, I'll add this option in next version.

Just to see IDs from XRef Materials and add them to MultiMattElement - but not to change them in XRef file.


beagle's picture

Doesnt work with ref workflow as Object ID Organiser

The script is great, but doesnt work with ref files.
same as Object ID Organiser.

pixamoon's picture


All sent,


wang_____yun's picture


ok.i have pay for it.i can't wait to use it!

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.