UnityAILab/blender-merge-lab
4
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions
2 releases 6 tags
  • v1.4.0 2d0507621e

    Merge Lab v1.4.0 Stable

    Sponge released this 2026-07-21 04:10:58 +00:00 | 2 commits to main since this release

    Merge Lab v1.4.0 — look-safe merging.

    This release makes merging safe by default: it will not change how your scene looks,
    in Blender or after a normal FBX/glTF export to Unity / VRChat.

    Fixes (from real-world feedback)

    • Name mode is now content-verified. It groups by base name and only merges blocks
      that are genuinely identical — including checking the referenced image file. A
      brick.001 that points at a different texture, or a recoloured .001, is left alone.
      This fixes "a merge swapped my textures / made things look different."
    • Fake-User protection no longer blocks merging. Pinned duplicates now merge onto a
      surviving canonical that keeps the pin — imported/pinned files no longer report
      "Merged 0" while nothing happens. You never lose a material you pinned.
    • Collapse Duplicate Slots now defaults ON, so joined meshes get their redundant
      material slots tidied in the all-in-one pass.
    • New advanced Force Merge by Name toggle (off) for the old name-only behaviour.
    • Identical generated images now merge safely.

    Verified

    Behaviour proven byte-for-byte identical on Blender 2.93.0 (Python 3.9.2) and 5.2.0
    (Python 3.13.13)    , including an independent per-face look test (material colour +
    image path + UVs unchanged before/after) and a real glTF export before/after.

    Install

    Download merge_lab.py below → Edit ▸ Preferences ▸ Add-ons ▸ Install… → enable
    Merge Lab → 3D Viewport N-panel → Merge Lab tab. Single file; Blender 2.93 → 5.x.
    See the README for full usage
    and cautions.

    Downloads
  • v1.3.1 d4ae11ace8

    Merge Lab v1.3.1 Stable

    Sponge released this 2026-07-21 03:38:28 +00:00 | 5 commits to main since this release

    Merge Lab de-duplicates the .001 / .002 datablocks Blender spawns when you copy
    objects — merging them back onto a single canonical block so your file stays lean and
    one edit updates every copy.

    What it de-duplicates

    • Materials (bpy.data.materials)
    • Images (bpy.data.images)
    • Textures — legacy bpy.data.textures (brushes / modifiers / particles)
    • Node Groups (bpy.data.node_groups)

    Plus an optional Collapse Duplicate Slots pass that compacts the redundant material
    slots on Ctrl+J-joined meshes, preserving the per-face look.

    Highlights

    • Name (strip .NNN) and Content (fingerprint) match modes.
    • All-in-one pass or per-type buttons.
    • Non-destructive Dry Run, fake-user protection, restrict-to-selected.
    • Remap-before-remove; removes only the orphans it creates (no orphans_purge).

    Compatibility

    Single file, Blender 2.93 LTS → 5.x. Behaviour proven byte-for-byte identical on
    Blender 2.93.0 (Python 3.9.2) and 5.2.0 (Python 3.13.13). Installs as a legacy add-on
    on 4.2+.

    Install

    Download merge_lab.py below → Edit ▸ Preferences ▸ Add-ons ▸ Install… → enable
    Merge Lab → open the N-panel Merge Lab tab.

    See the README for full usage
    and cautions.

    Downloads