IMM Brush Tool - v1.0.2

blender_version_min = "4.2.0"

📦 Installation

Getting started with the IMM Brush Tool is simple:

1. Download the .zip file included with your purchase.
2. Open Blender, go to Edit → Preferences → Add-ons, and click Install from Disk.

---

📍 Location

You’ll find the IMM Brush Tool in Sculpt Mode.

---

🛠️ How to use

🎨 Asset creation

1. Open Blender and add your objects.
2. Ensure origin, rotation, and scale are correctly set.
3. Select all objects, right-click in the Outliner, and choose Mark as Asset. This will create thumbnails.
4. Save the file and add its path to File Paths → Asset Libraries in Blender Preferences.
   The add-on only scans files in the top-level directory — recursive folder walking was removed due to performance issues and crashes with deeply nested folders.

🖌️ Using the tool

1. Open your project or start a new Blender file.
2. Switch to Sculpt Mode.
3. Select the IMM Tool.

📁 Asset selection

• Panel: Find the IMM Asset Selection Panel in the header or the Tools tab.
• Load: Choose your asset library path and brush file, then click Load to activate the tool.
• Session files: Loaded files are not saved with Blender and are removed when Blender closes, so you generally don't need to clear the cache afterward.
• Quick pick: Right-click in the 3D Viewport to choose your mesh manually, randomly, or sequentially.

⚙️ IMM properties

• Auto Target: Sets the target of brush object modifiers to the active object. Supported modifiers
  • SHRINKWRAP
  • DATA_TRANSFER
  • BOOLEAN
  • VERTEX_WEIGHT_PROXIMITY
  • MIRROR
  • GEOMETRY_NODES
  Note: In the Geometry Nodes modifier, the socket name must be "target", and it is not case-sensitive.
• Depth:
  • Positive values push the mesh into the surface.
  • Negative values pull it outward.
  • The slider accepts any numeric input.
• Scale Lock: Hold Ctrl to lock scale to the current value. The slider accepts any numeric input.
• Scale Sensitivity: Adjusts scaling responsiveness.
• Mirror: Mirror the mesh across the X, Y, or Z axis.
• Radial: Enables radial symmetry.
• Local: Uses the object’s local transform for Mirror and Radial operations.
• Link Object Data: This option shares mesh data only between objects created through Mirror or Radial duplication. It allows synchronized editing across those instances.If you no longer want the duplicated objects to share the same mesh: Switch to Object Mode. Select the objects you want to separate. Go to the Object menu → Relations → Make Single User → Object & Data.This will give each object its own independent mesh, breaking the shared link.