move_shape_key_vertices
Move vertices within a shape key to sculpt blend shapes. Apply local-space offsets per vertex or use vertex group weights for soft falloff.
Instructions
Move vertices inside a shape key, building the blend shape.
The offset is in the object's local space. With a vertex group, each vertex moves by offset times its weight, which gives soft falloff: weight the cheeks, then move them out to puff them.
Args: object_name: Mesh object. key_name: Shape key to edit (not the Basis). offset: [x, y, z] distance to move, each -1000 to 1000. vertex_indices: Vertices to move. Leave out to use vertex_group, or neither to move the whole mesh. vertex_group: Move by this group's weights instead of by index.
Returns: Dict with the number of vertices moved.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"object_name": "<object_name>",
"key_name": "<key_name>",
"offset": "<offset>"
},
"name": "move_shape_key_vertices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offset | Yes | ||
| key_name | Yes | ||
| object_name | Yes | ||
| vertex_group | No | ||
| vertex_indices | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||