Vi3W
Skip to content

Guides

Use Claude to fix weight painting problems in Blender

Use Claude and Blender MCP to fix weight painting: diagnose bad skinning, fix automatic weights, normalise, mirror, clean and smooth.

6 min read

A grey skeleton figure with a glowing spine, one hand raised in a wave
Illustration. Weights decide how much each bone moves each part of the mesh.

Quick answer

Can Claude fix weight painting in Blender?

Partly. Connected to Blender over MCP, Claude can diagnose bad skinning and run the mechanical fixes: re-parenting with automatic weights, normalising, limiting influences per vertex, cleaning stray weights, mirroring and smoothing vertex groups. The artistic part, painting a shoulder until it bends nicely, is still faster with your own brush.

What weight painting is, in one paragraph

Every vertex in a rigged mesh has a weight from 0 to 1 for each bone that can move it. Blender stores these as vertex groups named after the bones, and the Armature modifier uses them to deform the mesh when you pose the rig. Bad weights cause all the classic problems: a collapsing armpit, a knee that bends like rubber, a sleeve that follows the wrong arm, a belt that stretches when the character turns its head.

Weight problems are common on AI-generated and auto-rigged characters, because automatic weighting calculates from bone distance and the mesh's shape, and AI meshes often have fused parts and dense, uneven triangles. The good news: most of the fixes are mechanical, which is exactly what an assistant with Blender access does well.

Set Claude up with Blender

You need Claude connected to Blender over MCP, with either the official Blender Lab server or the community add-on. Setup is in connecting Claude to Blender. Save your file first. Both servers let Claude run Python inside Blender, and weight operations change data you can't always undo cleanly.

Step 1: diagnose before you paint

Start with a read-only request:

"Look at the selected character mesh and its armature. Report: whether the mesh has an Armature modifier and which object it points at, how many vertex groups there are, any vertex groups that don't match a bone name, any deform bones with no vertex group, how many vertices have more than 4 weights, and how many vertices have no weights at all."

That report finds most "weight painting does nothing" problems straight away:

  • No Armature modifier, or it points at the wrong rig. The mesh can't deform.
  • Vertex group names that don't match bone names. "upperarm_L" vs "upper_arm.L" means that group is ignored.
  • Unweighted vertices. These stay frozen in place when everything else moves: the classic "one spike left behind" bug. Our rig not moving the mesh guide has more causes.
  • Too many influences. Game engines usually limit each vertex to four bones. Extra weights get dropped on import, and the deformation changes.

Then ask for a stress test: "Pose the rig: left upper arm raised 90 degrees, right forearm bent 120 degrees, left thigh forward 70 degrees, spine twisted 30 degrees. Screenshot front and side." Now you know where it breaks.

Step 2: the mechanical fixes Claude does well

Redo the automatic weights

If the weights are a mess everywhere, start over: "Remove all vertex groups from the mesh and parent it to the armature again with automatic weights." That's Ctrl+P ‣ With Automatic Weights.

If Blender reports "Bone Heat Weighting: failed to find solution for one or more bones", the mesh is the problem. Ask Claude to:

  1. "Merge vertices by distance and report how many were removed." Duplicate vertices are the most common cause.
  2. "Apply scale on the mesh and the armature." Very small or unapplied scales break the calculation.
  3. If the mesh has intersecting or loose parts, "make a copy, Voxel Remesh it so it's one solid shell, skin the copy with automatic weights, then transfer the weights to the original with a Data Transfer modifier (nearest face interpolated)." This workaround fixes most AI-generated meshes.

Normalise

"Normalise all vertex groups on the mesh, locking none." That's Weights ‣ Normalize All in Weight Paint mode. It makes every vertex's weights add up to 1, which stops parts drifting or scaling oddly when posed.

Limit influences

"Limit total weights to 4 per vertex, then normalise all." That's Weights ‣ Limit Total. Do it before exporting to Unity, Unreal or Roblox, so what you see in Blender is what the engine plays.

Clean stray weights

"Clean all vertex groups with a limit of 0.01." That's Weights ‣ Clean. It removes the tiny weights that make a finger tug on the hip.

Remove a bone's weight from where it doesn't belong

The classic case is the head bone moving the shoulders, or the thigh pulling the skirt hem. Be specific:

"Remove all weight from the 'spine.004' group on vertices more than 5 cm below the neck bone's head, then smooth the group's border with 3 iterations."

Claude can select vertices by position, by distance from a bone, or by an existing group, which covers most "this bone affects too much" fixes.

Mirror

If one side is good: "Mirror the left-side vertex groups to the right, matching .L and .R bone names, using topology mirror if the mesh isn't symmetrical to the vertex." Weights ‣ Mirror does this. If your bone names don't use .L and .R (or _L and _R), Blender can't pair the groups. Ask Claude to rename them first.

A glass chat bubble linked by a bridge of light to a 3D scene
Illustration. Claude sends the weight operations; Blender runs them on your mesh.

Step 3: the part you should paint yourself

Some fixes are judgement calls: how soft the shoulder blend should be, where the elbow crease sits, how much the chest moves when the arm lifts. You can describe them to Claude, but it can't see the deformation the way you can, and five rounds of "a bit softer" costs more time than two minutes with a brush.

Select the armature, then the mesh, switch to Weight Paint mode, pick the bone whose influence you want to edit, and use:

  • Blur to soften harsh borders at joints.
  • Draw with low strength (0.1 to 0.2) to add weight gradually.
  • Subtract to remove influence from areas that stretch.
  • X mirror in the symmetry options, so both sides change together.

Then ask Claude to normalise and limit to four again, because hand painting breaks both.

AI characters: fix the mesh, not just the weights

If a character was generated with arms fused to its sides, or fingers as one block, no amount of weight painting makes it deform well. The vertices that should belong to the arm are shared with the torso. Better options:

  • Regenerate the character in an A-pose with arms clearly apart.
  • Rebuild a lighter, more even mesh first: Vi3W's Clean shape targets 500 to 20,000 faces. Uneven, very dense triangles weight badly.
  • Re-rig with Vi3W's Add bones, then fix only the leftovers in Blender. See auto-rigging through MCP.

Topology for animated AI characters explains why edge flow at the joints matters.

What Claude can't do here

  • Judge whether a bend looks right. It can measure, not feel. You approve every fix by posing.
  • Fix clothing physics. A dress that intersects the legs when walking needs its own bones, a cloth simulation or a corrective shape key, not only weights.
  • Make corrective shape keys artistically. It can set up the drivers, but sculpting the corrective shape is a brush job.
  • Undo everything. Some operations, like removing vertex groups, can't be fully recovered after you save. Version your files: "Save a copy as character_weights_v2.blend before each fix."

Fix one joint today

Pick the worst joint on your character, have Claude run the diagnosis and the mechanical fixes, then paint the last bit yourself. Need a rigged character to practise on? Generate one and use Add bones in Vi3W.

Frequently asked questions

how to fix weight painting blender

Find the bone that misbehaves, select its vertex group, and check which vertices it moves. Then remove its weight from areas it shouldn't affect, smooth the border, normalise all groups, and pose the rig again to test.

automatic weight paint blender not working

The usual cause is "Bone Heat Weighting: failed to find solution for one or more bones", which comes from overlapping or disconnected geometry, duplicate vertices or a very small scale. Merge by distance, apply scale, or skin a voxel-remeshed copy and transfer the weights.

how to mirror weight painting blender

Turn on X mirror in Weight Paint mode's symmetry options while you paint, or fix one side and use Weights ‣ Mirror with the bone names ending in .L and .R so Blender can match the groups.

weight painting does nothing blender

Usually the mesh has no Armature modifier pointing at the rig, the vertex group name doesn't match a bone name, or you're painting a different group from the bone you're posing. Check those three first.

Last reviewed