UnityAILab/blender-deform-doctor
4
0
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions
5 releases 5 tags
  • v1.3.0 d16158733a

    v1.3.0 Stable

    Sponge released this 2026-06-30 07:45:51 +00:00 | 6 commits to main since this release

    Deform Doctor v1.3.0 — Auto-Fix Clipping

    New

    • Auto-Fix Clipping button (Clothing / Clipping panel). One click to geometrically resolve body<->clothing clipping, with a Fix Direction:
      • Tuck Body Under Clothing - push body verts that poke OUT through a clothing layer back just inside it (for when the body clips through the clothes).
      • Push Clothing Off Body - push clothing verts that sink INTO the body back outside it.
      • Options: transfer weights first, resolve across All Poses, Margin / Reach / Iterations.
    • Iterative, transform-aware, skinning(LBS)-aware, and shape-key-aware (edits morph data so a shape-keyed body actually moves).

    Verified on test geometry: clothing-into-body penetration depth 0.081 -> 0.0025; body poke-through 191 -> 0.

    Install

    Download deform_doctor-1.3.0.zip -> Blender -> Edit > Preferences > Add-ons > Install from Disk -> enable. Panel: N-panel, Deform Dr tab.

    Built and tested on Blender 5.1.

    Downloads
  • v1.2.0 c53ef2b9ab

    v1.2.0 Stable

    Sponge released this 2026-06-30 06:51:48 +00:00 | 9 commits to main since this release

    Deform Doctor v1.2.0 — whole-avatar + clothing

    New

    • Whole-avatar scope. A Scope selector in Setup (Active Mesh / Whole Avatar). In Whole-Avatar mode the audit and every fixer (Normalize, Limit, Prune, Remove-Empty, Smooth, and one-click Auto Clean) run across EVERY mesh bound to the armature in one pass — body + all clothing/accessory layers. A true global fix.
    • Clothing / Clipping panel. Detect where clothing penetrates the body:
      • Check Clipping (this pose) — BVH-based penetration test, painted per clothing mesh (grey = clean, hot = deep).
      • Sweep Clipping (all poses) — worst-case penetration any clothing vert reaches across every pose.
      • Transfer Weights Body -> Clothing — copies the body deform weights onto clothing (Data Transfer) so they move together and stop clipping. Run Limit-to-4 + Normalize (Whole Avatar) afterward.
    • Hardened mesh evaluation and viewport-color helpers for headless/odd contexts.

    Install

    Download deform_doctor-1.2.0.zip -> Blender -> Edit > Preferences > Add-ons > Install from Disk -> enable "Deform Doctor". Panel: 3D viewport N-panel, Deform Dr tab.

    Built and tested on Blender 5.1.

    Downloads
  • v1.1.0 6015f056b9

    v1.1.0 Stable

    Sponge released this 2026-06-30 06:25:55 +00:00 | 12 commits to main since this release

    Deform Doctor v1.1.0

    New

    • Simple / Advanced UI toggle at the top of the panel. Simple shows only the essentials (Set From Selection, Audit Weights, Sweep All Poses, Snap Before/After + Show, and one-click Auto Clean Weights) so the tool is not overwhelming for new users. Advanced reveals every operator and property. Defaults to Simple.
    • Full DOCS.md reference shipped in the repo (panels, operators, properties, workflows, gotchas, troubleshooting, architecture).

    Install

    Download deform_doctor-1.1.0.zip -> Blender -> Edit > Preferences > Add-ons > Install from Disk -> enable "Deform Doctor". Panel: 3D viewport N-panel, Deform Dr tab.

    Built and tested on Blender 5.1.

    Downloads
  • v1.0.1 263ec8aee4

    v1.0.1 Stable

    Sponge released this 2026-06-30 06:15:19 +00:00 | 16 commits to main since this release

    Deform Doctor v1.0.1 — bug fix.

    Fixed

    • Weight operators (Smooth, Normalize, Limit, Prune, Remove Empty) no longer error when run while the mesh is in Edit Mode or Weight-Paint Mode. They now auto-switch to Object Mode for the write and restore your previous mode. Previously they threw "VertexGroup.add(): cant be called in edit mode".
    • Smooth now reads the vertex selection correctly when launched from Edit Mode (the selection is flushed first), so "smooth selected verts only" works as intended.

    No behavior change for anyone already running the tools from Object Mode.

    Install

    Download deform_doctor-1.0.1.zip -> Blender -> Edit > Preferences > Add-ons > Install from Disk -> enable "Deform Doctor". Panel: 3D viewport N-panel, Deform Dr tab.

    Built and tested on Blender 5.1.

    Downloads
  • v1.0.0 4a239a66c8

    v1.0.0 Stable

    Sponge released this 2026-06-30 05:43:55 +00:00 | 18 commits to main since this release

    Deform Doctor v1.0.0 — first release.

    A single-file Blender addon: a deformation debugger and fixer in one, built for skinned characters headed into game engines (VRChat in particular).

    Highlights

    • Diagnose — weight audit (unweighted / over-influence-limit / non-normalized), distortion heatmap (rest vs pose), and a multi-pose sweep that paints the worst-case stretch any vertex sees across every pose you list.
    • Before / After — overlay ghost (red wireframe over the live solid, nothing hidden) or clean side-by-side, with an opt-in grey diff map that tints only the verts that moved.
    • Fix — one-click Auto Clean Weights runs the safe order (normalize -> smooth -> normalize -> limit-to-N -> normalize) with auto Before/After snapshots, plus manual steps.

    Install

    Download deform_doctor-1.0.0.zip -> Blender -> Edit > Preferences > Add-ons > Install from Disk -> pick the zip -> enable "Deform Doctor". Panel: 3D viewport N-panel, Deform Dr tab.

    Built and tested on Blender 5.1.

    Downloads