updateJoints
Modify multiple 3D joints simultaneously by updating properties like position, rotation, scale, and visibility in the 3D-MCP server. Streamline joint adjustments with a single operation for efficient 3D model editing.
Instructions
Update multiple Joints in a single operation
Input Schema
Name | Required | Description | Default |
---|---|---|---|
items | Yes | Array of Joints to update with their IDs |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"items": {
"description": "Array of Joints to update with their IDs",
"items": {
"additionalProperties": false,
"properties": {
"castShadow": {
"default": true,
"description": "Whether the object casts shadows",
"type": "boolean"
},
"childIds": {
"default": [],
"description": "Child object IDs",
"items": {
"type": "string"
},
"type": "array"
},
"ids": {
"description": "Joint identifiers to update",
"items": {
"type": "string"
},
"type": "array"
},
"length": {
"default": 1,
"description": "Length of the joint",
"minimum": 0,
"type": "number"
},
"locked": {
"default": false,
"description": "Editing lock state",
"type": "boolean"
},
"metadata": {
"additionalProperties": {},
"description": "Additional tool-specific metadata",
"type": "object"
},
"name": {
"description": "Display name",
"type": "string"
},
"orientation": {
"$ref": "#/properties/items/items/properties/rotation",
"default": [
0,
0,
0,
1
],
"description": "Local orientation for the joint"
},
"parentId": {
"default": null,
"description": "Parent object ID",
"type": [
"string",
"null"
]
},
"position": {
"default": [
0,
0,
0
],
"description": "Position [x, y, z]",
"items": {
"type": "number"
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"preferredRotationAxis": {
"$ref": "#/properties/items/items/properties/position",
"description": "Preferred axis for rotation (for resolving rotation ambiguity)"
},
"receiveShadow": {
"default": true,
"description": "Whether the object receives shadows",
"type": "boolean"
},
"renderOrder": {
"default": 0,
"description": "Render sorting order",
"type": "integer"
},
"rotation": {
"default": [
0,
0,
0,
1
],
"description": "Rotation quaternion [x, y, z, w]",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
"scale": {
"$ref": "#/properties/items/items/properties/position",
"default": [
1,
1,
1
],
"description": "Scale [x, y, z]"
},
"visible": {
"default": true,
"description": "Visibility state",
"type": "boolean"
}
},
"required": [
"ids"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
}