theanine3D / mat-batch-tools

Blender addon that allows batch modification of many materials and nodes simultaneously, and automates common repetitive tasks on models with many materials

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Material Batch Tools

Addon for Blender (3.x+ / 4.x+) that can perform batch modifications of many materials and nodes simultaneously, automating common repetitive tasks on models with many materials. The addon dramatically speeds up the process of preparing models for baking, especially when baking many textures into one - such as with megatextures, texture atlases, etc.

Finding this addon useful? Please consider starring it ⭐, or donating 🙂
image

Features:

  • Node Unify - Set a selected node as a template, and then apply its settings to all other nodes of the same type, in all materials, in all selected objects.
    • Optional filter allows you to restrict Node Unify's effect to only nodes that have a specific label set on them.
  • Bake Target Node - Copy / paste your own customized Image Texture node into all materials on all selected objects, for use with baking
    • The created Image Texture node is set as "active" automatically, making it ready as a target for baking
    • The node is always positioned automatically to the right of the Material Output node, for easy finding
    • Optional color setting allows you to add a color decoration to the node, making it easier to identify
  • Batch rename of UV maps and vertex colors on all selected objects at once
  • Automatically add and connect a UV Map node (with a specific UV Map set) to all Image Texture nodes, in all materials in all selected objects at once
    • The UV Map node is selectively added based on a user-specified image format (ie. PNG, HDR). This allows you to, for example, selectively add a "lightmap" UV Map node only to any HDR Image Texture nodes.
  • Switch between Opaque, Alpha Clip, and Alpha Blend, in all materials on all selected objects, with an optional filter based on the shader (Principled BSDF or Transparent BSDF) present in the material
  • Material Templates - Replace the entire node setups in all materials in all selected objects, with common node setups. For example, if you bake your scene's lighting into vertex colors, there is a material template that you can apply that automatically blends the baked vertex colors onto the albedo textures in all materials.
  • Shader Switch - instantly swap the Principled BSDF shader with the Emission shader, or vise versa, in all materials in all selected objects. Useful for instantly toggling fullbright on/off on a model. The first input/output connections for the original shader are preserved.
  • Find/Copy/Paste Active Face Texture - Allows you to quickly find, copy, and paste the diffuse texture of the currently active or last selected face. The Find operator loads the texture in the Image Editor. All 3 operators be found by search and assigned to your Quick Favorites for easy access, or accessed via Blender's Image Editor's "Image" menu
  • Copy Diffuse Texture to Material Name - Finds the diffuse texture in all materials, in all selected objects, and if one is found, the diffuse texture's name is copied to its material's name. Can be accessed from the UV Editor's "Image" menu.

Installation

  1. For the newest, bleeding edge version, download mat_batch_tools.py (right click this link and Save As...) If you want a more stable release, check the Releases.
  2. Go into Blender's addon preferences (File → Preferences → Addons)
  3. Click the "Install..." button and browse to mat_batch_tools.py, select it, and press "Install Add-on"

(Note: The .PY file is installed directly, without a ZIP file)

Notes

  • Not every operator in this addon is undoable. Keep a backup copy of your blend file just in case you need to restore something.
  • Most operators in this addon affect all currently selected mesh objects, not just one object. Make sure you double check which objects you have selected before running any of them.

Previews:

The interface - found in the Material Properties tab

image

Material Templates

material templates

Node Unify

node unify

Automatic creation, assignment, and linking of UV Map nodes for all Image Textures:

uvmap

Bake Target

bake target

Shader Switch

shader switch

About

Blender addon that allows batch modification of many materials and nodes simultaneously, and automates common repetitive tasks on models with many materials

License:GNU General Public License v3.0


Languages

Language:Python 100.0%