Blend Shape Mode Guide
A step-by-step workflow for Blend Shape mode — prepare a rigged object, import or create a shape, sculpt it, add in-between frames, set the weights, and use or bake the result.
This guide walks through a complete Blend Shape mode workflow: making a Smile expression on a character's face, checking it, and handing it to Unity's animation tools.
1. Prepare the object
Blend shapes need rigging.
- A model that already has blend shapes — select it and run UModelerize. The shapes, their frames and their current weights are imported. If the mesh has blend shapes but no bones, rigging is turned on for you.
- A UModeler X object — open the Rigging tab and press Start Rigging. See Rigging Mode.
Then open the Blend Shape tab. If the tab shows a notice, read it — it tells you what is missing, or that a modifier removes blend shapes from the result while it is enabled (see Modifier).
2. Create a shape
-
Press + under the shape list. A shape named Shape appears, is selected for editing, and its weight goes to 100.
-
Double-click the name and type Smile.
Imported shapes are already in the list. Click one to edit it.
3. Sculpt the shape
-
Turn on Symmetry with the Sym button or Shift + Y, so both mouth corners move together. See Symmetry.
-
Pick a tool:
- Vertex, Edge or Face (Shift + 1, 2, 3) — select elements and move, rotate or scale them with the gizmo. Soft Selection gives smooth falloff.
- A Deform brush, such as Move Brush or Standard Brush — paint the change directly.
-
Shape the smile. Only the Smile shape changes; the base mesh stays as it is.
If an edit is refused, a message in the Scene view explains why — for example Select a blend shape to edit it. or 'Smile' is locked. Unlock it to edit it.
4. Add in-between frames (optional)
A single frame blends linearly from 0 to 100. To control the path, add an in-between frame:
-
Drag the Smile slider to 50.
-
Edit the shape. Because no frame exists at 50, UModeler X adds Frame 1 (50) and shows Added frame 1 at weight 50 to 'Smile'. The frame starts from what you see, so nothing jumps.
-
Click a frame row to jump the weight to that frame and edit it.
You can also type a weight next to + under the frame list and press +. See Shape and Frame Lists.
5. Make left and right versions (optional)
Right-click Smile and choose Split Left/Right. Two new shapes, Smile_L and Smile_R, are made from the halves; the original stays. Vertices near the center line are shared between both halves with a soft blend. The split follows the symmetry axis: with Y or Z the item reads Split Top/Bottom or Split Front/Back. See Shape Menus.
6. Check and set the weights
- Drag the sliders to mix shapes. S (Solo) shows one shape alone; the eye icon hides one.
- Right-click a shape and choose Show Delta Heatmap to color the moved vertices by distance.
- The tab weights are temporary. They are dropped when you leave the tab, and once you leave the object the Skinned Mesh Renderer shows each shape's initial weight. A
*next to a name means its weight differs from the initial weight. - To keep a weight — for example a body shape that should always be on — right-click the shape and choose Save Weight, or use Save All Weights in the list menu.
7. Use the result
Animate it — the shapes live on the object's Skinned Mesh Renderer under their names, in list order. Key their weights in Unity's Animation window or Timeline, or let other tools drive them by name. ARKit names are what face-tracking apps look for, and the VRChat viseme names are what the avatar descriptor's lip-sync detection looks for.
Bake it — Apply to Basis adds the edited shape at its current weight to the base mesh and deletes the shape; Apply All does the same for every unlocked shape. Extract Mix as Object copies what you see into a new, separate object.
Sculpting in a separate object
You can sculpt a shape as its own object and bring it back:
-
Show only the shape you want, at weight 100 — for example with S (Solo).
-
In the list menu, choose Extract Mix as Object. A new object named after this object and the shape, such as Head_Smile, appears in the same place.
-
Sculpt the new object with any Modeling tool. Move vertices only — do not add or delete any — so every vertex matches exactly. You can move the copy aside to work next to the original; matching uses each object's local coordinates.
-
Select the original object again, open the Blend Shape tab, and choose Update from Objects in the list menu. Every shape that has a matching ObjectName_ShapeName object in the scene is rebuilt from it.
Tips
- Edit the position first and the normals last. Moving vertices resets the custom normals in that area to calculated ones.
- Lock finished shapes with the lock icon so no tool or menu changes them by accident.
- Use Copy Deltas — with Selected Vertices Only, or a Strength below 1 — to start a new expression from part of an existing one.
See also — Blend Shape Mode · Shape and Frame Lists · Shape Menus · Edit Group
