SceneMedic — Documentation

Installation

1. Download scenemedic.zip from your Superhive purchases (do not unzip it)
2. In Blender: Edit > Preferences > Add-ons
3. Click the dropdown arrow (top-right) > Install from Disk...
4. Select the downloaded zip
5. Tick the checkbox next to SceneMedic to enable it
6. In the 3D Viewport press N to open the side panel — you'll find the SceneMedic tab

Requires Blender 4.2 or newer. No external dependencies.

Quick Start (20 seconds)

1. Open the SceneMedic tab in the 3D Viewport N-panel
2. Click Diagnose Scene
3. Read the findings list and the Potential savings figure
4. Click Treat All Safe Issues
5. Diagnose runs again automatically — watch the savings figure drop to zero

Always work on a saved file. Every treatment supports Ctrl+Z, but a saved copy is good practice before any bulk operation.

The Six Checks

Duplicate Materials

Finds materials with identical shader node setups — the classic WoodMat, WoodMat.001, WoodMat.002 situation created by appending assets or importing files repeatedly.

Materials are compared by fingerprinting the actual node graph: node types, their input values, and any image texture filepaths. Two materials merge only if their setups genuinely match. A material you deliberately tweaked (different roughness, different texture) will never be merged away.

Duplicate Images

Finds multiple image datablocks pointing at the same file on disk. Appending assets from several files is the usual cause. Each redundant datablock consumes texture memory for no benefit.

Instanceable Meshes

The biggest performance win. Finds objects whose mesh data is geometrically identical but stored separately — the result of duplicating with Ctrl+D or importing repeated props.

Meshes are fingerprinted by vertex/edge/face counts, material slot count, and sampled vertex coordinates. Objects whose mesh data is already shared (linked duplicates) are skipped automatically.

Orphan Data

Finds datablocks with zero users — data that remains in the file but nothing references. Checked across meshes, materials, images, node groups, actions, textures, curves, and armatures.

Oversized Textures

Flags any image larger than your chosen cap — 1K, 2K, 4K, or 8K — and estimates the memory reclaimable by downscaling.

Missing Files

Finds image datablocks whose file paths are broken. These render as blank or pink in your scene. Packed images are correctly ignored.

Reading the Report

Each finding shows a category icon, a plain-language summary ("12 object(s) can share mesh data"), and where applicable an estimated memory saving. Click any row to see additional detail below the list.

The headline Potential savings figure is the sum of all findings. Treat it as a good-faith estimate, not an exact measurement — Blender does not expose precise per-datablock memory usage to addons, so figures are calculated from vertex counts, image dimensions, bit depth, and channel counts.

Treatments

Treat All Safe Issues

Runs in this order, then re-diagnoses automatically:

1. Merge duplicate materials
2. Merge duplicate images
3. Auto-instance identical meshes
4. Purge orphan data

What "safe" means here: every operation in Treat All is an in-file data operation, fully undoable with Ctrl+Z, and does not touch any file on your disk. Two treatments are deliberately excluded from Treat All and remain manual-only:

• Downscale Oversized Textures — alters image data in memory
• Find Missing Files — reads from disk and rewrites file paths

Individual Treatments (collapsible sub-panel)

• Merge Duplicate Materials — remaps duplicates to a single original, then removes the copies
• Merge Duplicate Images — same, for image datablocks sharing a filepath
• Auto-Instance Meshes — repoints identical objects at a single shared mesh datablock and removes the freed data
• Purge Orphan Data — recursive purge, run in several passes because purging can free up further orphans
• Downscale Oversized Textures — scales images down to your cap, preserving aspect ratio
• Find Missing Files — opens a folder picker and searches it recursively to relink broken paths

Scene Stats (collapsible sub-panel)

Object count, mesh/material/image datablock counts, total vertices, total triangles, and estimated texture memory. Populated after a diagnosis.

Recommended Workflow

• Before saving a milestone or delivering a file: Diagnose > Treat All. Files handed to clients or teammates should never carry orphan bloat.
• After appending or importing assets: appending is the single biggest source of duplicate materials and images. Run a diagnosis right after.
• When the viewport starts stuttering: run a diagnosis and look specifically at the instanceable meshes finding — un-instanced duplicates are the most common cause.
• Before rendering on a farm: check for missing files and oversized textures.

Version History

v1.0.0 — Initial release. Six diagnostic checks, Treat All, six individual treatments, Scene Stats panel, savings estimator.

Support

Use the Contact Creator button on this page. Please include your Blender version and a screenshot of the findings list. If a treatment behaves unexpectedly, a .blend file that reproduces it gets the fastest fix.