Blender 4.2+ Addon · v1.0

Fit finished garments onto a new body. Without breaking them.

Wretch AutoFit non-destructively transfers clothing from one body shape to another — preserving topology, vertex order, UVs, materials, and every wrinkle of detail. Built for Second Life body conversions (Legacy, eBody Reborn, Maitreya) and beyond.

Wretch AutoFit — garment fitted live from Legacy to a target body
Live Fit preview updating in the viewport while settings change.

What it does

A complete fitting pipeline inside the Blender sidebar — no rigging, no proxies, no re-modelling.

Non-destructive by design

The original garment is never touched. AutoFit duplicates it and writes the result into an AutoFit_Result shape key — topology, vertex order, UVs, materials, and custom data layers all survive intact.

Live Fit preview

One click starts a modal live preview. Adjust fit strength, shape match, hug, and clearance while the fitted duplicate updates in the viewport. Apply when it looks right, or cancel cleanly.

Dense Body Shape Transfer

Per-vertex barycentric attachments rebuild the fit against the target body's actual surface — not just sparse landmarks. Tight areas track the body; loose fabric keeps its draped silhouette.

Garment classification

Automatic detection of tight, loose, structured, collar, cuff, hem, zipper, rigid, and locked regions — each fitted with its own behavior. Manual correction is one button click in Edit Mode.

Smart body profiles

Measured landmark detection finds the waist, hips, bust, crotch, and limb joints automatically. Editable handles, GPU marker overlay, and an interactive drag-to-edit mode with Ctrl-snap to the body surface.

Detail that survives

Wrinkles, ruffles, and trim are separated from the broad deformation, rotated with the surface, and reapplied afterward. Edge Relax and detail-safe collision keep the fabric looking like fabric.

Install

  1. In Blender, open Edit > Preferences > Add-ons and click Install…
  2. Select the zip file Wretch_AutoFit_v1_0.zip.
  3. Enable Wretch AutoFit.
  4. Find the panel in View3D > Sidebar (N) > Wretch AutoFit.

Requires Blender 4.2 or newer.

Starter Guide

Your first fit in ten steps. You need three objects in the scene: the source body the garment was made for, the target body you want it on, and the garment itself.

  1. Select your three objects

    Select the source body, the target body, and the garment. Make the garment the active object (select it last).

  2. Open the sidebar panel

    Press N in the 3D viewport and open the Wretch AutoFit tab. Click Assign From Selection — the addon sorts out which object is which.

    Sidebar panel with the three objects assigned
    The sidebar after Assign From Selection.
  3. Create body profiles

    In Body Profiles, generate a starter profile for the source body and one for the target body. Profiles are JSON metadata (landmarks + soft regions) — they never store the mesh itself, and they're saved for reuse.

  4. Check the landmarks

    Create landmark handles and verify the auto-detected positions. The detector measures the mesh to find the waist, hips, bust, neck, crotch, armpits, and limb joints — but manual verification pays off. Click Edit Landmarks (Interactive) to drag markers directly in the viewport; hold Ctrl to snap them onto the body surface. Save when done.

    GPU landmark markers on a body, one highlighted under the cursor
    Interactive landmark editing with hover highlighting.
  5. Validate the profiles

    Run profile validation. It flags missing landmarks and suspicious left/right or vertical placements before they can ruin a fit.

  6. Set up the fit

    For a first try, keep it simple: enable Body Profiles, leave Body Shape Transfer at 1.0, and keep Body Hug and Surface Clearance off until the basic silhouette is right.

  7. Create the fitted duplicate

    Click Create Fitted Duplicate. This starts Live Fit: a duplicate appears, fitted to the target body, and keeps updating as you change settings. The original garment is locked and untouched.

    Slider being dragged, fitted garment updating live
    Live Fit: tune settings, watch the result.
  8. Tune while watching

    Adjust Fit Smooth if you see stepping, Edge Relax if the mesh stretches unevenly, and Surface Guide carefully (low values for loose garments). Then, if the garment should sit tighter, enable Body Hug; if it clips into the body, enable Surface Clearance.

  9. Apply or cancel

    Apply Live Fit keeps the fitted duplicate — the result lives in its AutoFit_Result shape key. Cancel Live Fit removes the preview with no trace. If live mode ever gets stuck, Force Exit Live Fit in the sidebar cleans up safely.

  10. Reuse your profiles

    Profiles are saved in Blender's user config under Wretch_AutoFit/profiles and can be exported as JSON for sharing. The next garment between the same two bodies skips straight to step 6.

Recommended settings

Starting points for common situations. All values are adjustable live during the fit.

Large proportion changes (e.g. Legacy → eBody Reborn)
SettingValue
Body Shape Transfer1.00
Fit Smooth2 – 4
Edge Relax0.40 – 0.80
Preserve Detail1.00
Surface Guide0.00 – 0.20
Torso Shape Match0.75 – 1.00
Tight tops
SettingValue
Fit Strength1.0
Surface Guide0.3 – 0.6
Body Hugenabled
Hug Strength0.45 – 0.75
Hug Offset0.003 – 0.006
Hug Passes2 – 4
Hug Smooth1 – 3
Preserve Detail1.0
Deep clipping fixes
SettingValue
Surface Clearanceenabled
Clearance0.004 – 0.008
Clearance Strength0.8 – 1.0
Collision Passes3 – 6
Detail-Safe Collisionenabled
Collision Smooth2 – 4
Final Guard0.05 – 0.20
Limb garments (socks, sleeves, leg warmers)
Garment typeLimb Shape Match
Loose socks, leg warmers0.25 – 0.60
Tight socks, leggings, sleeves0.70 – 1.00

FAQ & Troubleshooting

The fitted garment collapses into cleavage, armpits, or between the thighs.
Lower Surface Guide — for loose or semi-loose garments, 0.05 – 0.25 is safer than a hard body snap. The dense transfer already keeps loose fabric on a coherent regional envelope; Surface Guide should only nudge tight areas.
The garment still clips into the body, but collision is eating my wrinkles.
Lower Final Guard first. If clipping remains, increase Collision Passes or Clearance Strength instead of raising Final Guard, and keep Detail-Safe Collision enabled.
A sock or boot ends up offset or only approximately rotated.
The knee and ankle landmarks are the critical ones for lower-leg garments. Position and save left/right_hip, left/right_knee, and left/right_ankle on both bodies, and use Live Landmark Preview to fine-tune while watching the garment.
I want the garment tighter, but collision only pushes outward.
That's what Body Hug is for: it pulls the smoothed garment envelope inward toward the target body, then restores wrinkles and detail afterward.
Live Fit got stuck.
Click Force Exit Live Fit in the sidebar. It clears the live-fit state and removes preview duplicates — confirmed (applied) fits are never touched by this cleanup.
Can I just use bounds matching instead of profiles?
Only for similar bodies. Whole-body bounds are dominated by arm span, bust depth, and height, so one global scale can't preserve a finished garment across very different proportions. For Legacy ↔ eBody Reborn–scale changes, always use Body Profiles.

Stop re-modelling. Start refitting.

One garment, every body — with the topology and detail you finished it with.

Install Wretch AutoFit