configure_anatomical_mask
Configures anatomical region masks or vertex groups on a Blender mesh using spatial falloff and optional bilateral symmetry, so you can isolate features like horns or wings for targeted editing.
Instructions
Configure an anatomical region mask / vertex group on a designated mesh object (e.g. Horns, Wings, Scales) with smooth spatial weight falloff and optional bilateral symmetry.
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": {
"target_object": "<target_object>",
"mask_name": "<mask_name>"
},
"name": "configure_anatomical_mask"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| radii | No | Optional [rx, ry, rz] radii for ellipsoidal region bounds. | |
| action | No | Action to perform: 'SET' assigns weights, 'ADD' sums with existing, 'SUBTRACT' subtracts, 'CLEAR' zeroes group. | SET |
| center | No | Center coordinate [x, y, z] for spherical, cylindrical, or bounding regions. | |
| radius | No | Radius in meters for SPHERE or CYLINDER region types. | |
| falloff | No | Weight falloff curve from region center to outer boundary. | SMOOTH |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted. | |
| mask_name | Yes | Name of the anatomical vertex group / mask (e.g. 'Horns', 'Wings', 'Body_Scales', 'Spine_Ridges'). | |
| max_weight | No | Maximum peak weight at region center. | |
| min_weight | No | Minimum weight outside or at region perimeter. | |
| object_name | No | Alias for target_object. | |
| region_type | No | Spatial or geometric region formula used to evaluate vertex membership weights. | SPHERE |
| normal_vector | No | Direction vector [x, y, z] for NORMAL_FACING region type (e.g. [0, 0, 1] for dorsal). | |
| region_bounds | No | Optional bounding box [xmin, ymin, zmin, xmax, ymax, zmax] for BOUNDING_BOX region type. | |
| symmetry_axis | No | If specified (e.g. 'X'), evaluates and mirrors mask weights symmetrically across the plane. | NONE |
| target_object | Yes | Name of the target mesh object in the Blender scene. | |
| normal_tolerance | No | Alignment tolerance for NORMAL_FACING (dot product threshold = 1.0 - normal_tolerance). | |
| rollback_on_failure | No | If true, rolls back vertex group modifications on error. |