uv_unwrap
Unwraps selected or all mesh faces into UV coordinates with angle-based or conformal methods, adjustable seam margins, aspect correction, and hole filling.
Instructions
Unwraps selected or all faces of a mesh object into UV coordinates using Blender's Edit Mode unwrap engine. Supports angle-based (ABF) and conformal (LSCM) methods, seam packing margin, aspect correction, and hole filling.
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": {
"name": "<name>"
},
"name": "uv_unwrap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Target mesh object name. | |
| faces | No | Faces to unwrap: 'all' (all faces), 'selected' (currently selected faces in edit mode), or a list of integer face indices [0, 1, 2]. Defaults to 'all'. | all |
| margin | No | Space between UV islands (0.0 to 1.0). Defaults to 0.001. | |
| method | No | Unwrap method: 'ANGLE_BASED' (conformal / ABF, standard) or 'CONFORMAL' (LSCM). Defaults to 'ANGLE_BASED'. | ANGLE_BASED |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| uv_layer | No | Target UV map layer name. Defaults to 'UVMap'. | UVMap |
| fill_holes | No | Virtually fill holes in mesh before unwrapping to avoid overlapping. Defaults to True. | |
| correct_aspect | No | Map UV coordinates taking image or object aspect ratio into account. Defaults to True. | |
| expected_snapshot_id | No | Optional SHA-256 snapshot id for optimistic concurrency control. |