Overview

WeightForge Pro is an advanced Blender add-on for character skinning, weight transfer, weight cleanup, and deformation diagnostics. It provides a complete set of tools for binding meshes to armatures, transferring weights between objects (especially body-to-clothing), cleaning and optimizing weights, diagnosing deformation issues, and applying specialized binding methods for organic and hard-surface assets.

Key capabilities include:

• Smart binding with multiple algorithms
• Intelligent body-to-clothing weight transfer
• Advanced weight cleanup and influence control
• Live deformation heatmaps and problem detection
• Joint gradient tools
• Rigid and hierarchy binding for mechanical parts
• Voxel-based weight generation
• Export readiness reporting

Compatibility

• Minimum Blender version: 4.2.0
• Primary target: Blender 5.2
• License: GPL-3.0-or-later

Installation

1. Download the WeightForge Pro ZIP file. Do not extract it.
2. In Blender, go to Edit → Preferences → Add-ons.
3. Click Install from Disk, select the ZIP file, and enable WeightForge Pro.
4. In the 3D Viewport, press N to open the Sidebar.
5. Locate the WeightForge or WF Pro tab.

Interface Overview

The add-on appears in two main locations in the Sidebar (N-panel):

• WeightForge – Main workflow panels (Bind, Cleanup, Diagnostics, Export, etc.)
• WF Pro – Advanced skinning tools including voxel weight generation

Features

1. Smart Bind

Automatically generates vertex weights from an armature using one of three algorithms:

Options:

• Bind selected bones only
• Preserve existing weights
• Influence zone visualization with adjustable size

Workflow:

1. Select the mesh object(s).
2. Shift-select the armature last (so it is active).
3. Choose the desired algorithm and options.
4. Click Smart Bind.
5. Pose-test major joints and refine as needed.

2. Weight Transfer

Transfers weights from a source mesh (typically a body) to one or more target meshes (clothing, accessories, armor, etc.).

Transfer Methods:

• Proximity
• Normal-aware
• Topology
• Hybrid

Options:

• Preserve / blend existing target weights
• Maximum transfer distance
• Transfer strength
• Automatic smoothing after transfer

Workflow:

1. Select the clothing/target object(s).
2. Select the weighted source (body) last so it is active.
3. Choose transfer method and distance settings appropriate to your scene scale.
4. Click Transfer.
5. Inspect garment boundaries, joints, and overlapping areas. Clean up if necessary.

3. Weight Cleanup Tools

Smart Smooth restores the user’s previous vertex selection, paint mask, and mode after execution.

4. Deformation Diagnostics

Live Deformation Heatmap
Displays a color-coded heatmap of deformation quality that updates while posing. Toggle it on/off directly from the panel.

Problem Detection
Identifies vertices with common weight issues (conflicting influences, poor falloff, etc.).

Snapshots & Comparison

• Save before/after weight snapshots
• Generate a comparison heatmap showing differences (including cases where total vertex weight remains the same but distribution between bones has changed)

Export Readiness Report
Generates a text report covering:

• Maximum influence count
• Normalization status
• Unweighted vertices
• Other export-critical metrics

The report opens in a Text datablock (accessible via the Text Editor).

5. Rigging Utilities

Joint Gradient
Creates smooth, natural blending between two bones (especially useful for elbows, knees, and shoulders).

Rigid Bind
Binds selected vertices or objects rigidly to a single bone (ideal for hard-surface parts, armor plates, mechanical components).

Hierarchy Bind
Binds objects according to a bone hierarchy starting from a chosen root bone.

Additional Tools:

• Align origin to bone
• Bone rotation helpers
• Rig type detection and Rigify weight redirection support
• Influence zone visualization
• Optional pie menus for faster access

6. Voxel Weight Generation (WF Pro)

Generates high-quality weights using a voxel-based surface diffusion approach:

1. Creates a temporary geometry-only copy of the source mesh.
2. Voxel-remeshes the temporary copy (original mesh geometry is never modified).
3. Seeds deform-bone weights using world-space distance to bone segments.
4. Diffuses the weights across the remeshed surface graph.
5. Projects the final weights back onto the original mesh.
6. Removes the temporary geometry.

Controls:

• Voxel Size (relative to character scale)
• Diffusion Iterations
• Diffusion Strength
• Maximum Influences
• Preserve existing weights option

Recommended workflow:

1. Select the mesh object(s), then make the armature active.
2. Open the WF Pro tab.
3. Set Voxel Size according to the character’s scale (smaller = denser temporary mesh, higher quality, more memory).
4. Adjust diffusion iterations, strength, and max influences.
5. Run Generate Voxel Diffusion Weights.
6. Pose-test shoulders, elbows, wrists, hips, knees, and any intersecting garments.
7. Refine with cleanup tools if needed.

Recommended Workflows

Standard Character Binding

1. Smart Bind (Hybrid recommended as starting point)
2. Pose-test major joints
3. Use Smart Smooth + Limit Influences
4. Run Export Readiness Report

Clothing / Layered Assets

1. Ensure body has clean weights
2. Transfer Weights (Hybrid or Normal-aware usually works best)
3. Adjust Max Transfer Distance to scene scale
4. Inspect and clean boundaries
5. Optional: Joint Gradient on key areas

Hard-Surface / Mechanical Parts

1. Use Rigid Bind for individual plates/parts
2. Or Hierarchy Bind when a logical bone chain exists

Difficult Geometry

1. Use Voxel Weight Generation as the initial binding method
2. Follow with cleanup and diagnostics tools

Troubleshooting

When reporting issues, include:

• Blender version
• Operating system
• WeightForge Pro version
• Exact steps to reproduce
• Full Python traceback (if any)
• A minimal .blend file when possible

Best Practices

• Always keep a backup of production scenes before major weight operations.
• Pose-test results thoroughly, especially around joints, fingers, facial areas, and layered clothing.
• Use the Export Readiness Report before exporting to game engines or other software.
• Combine tools: Voxel or Smart Bind → Cleanup → Diagnostics → Manual refinement where needed.
• For clothing, start with a well-weighted body mesh. Transfer quality depends heavily on source quality.

License

WeightForge Pro is released under the GPL-3.0-or-later license.
See the included LICENSE file for the full text.

Copyright © 2026 Anvil Interactive Solutions