open_blend_file
Load an existing Blender .blend project from disk, replacing the current scene and discarding unsaved changes only when confirmed. Embedded Python scripts stay disabled unless explicitly allowed.
Instructions
Safely load and open an existing Blender (.blend) project file from disk. WARNING: Unloads current scene and datablocks. Requires confirm_discard_unsaved=True if current scene has unsaved modifications. Disables untrusted embedded scripts by default.
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": {
"filepath": "<filepath>"
},
"name": "open_blend_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| filepath | Yes | Absolute filesystem path to the target .blend file to open. | |
| use_scripts | No | Whether to allow embedded Python scripts in the opened file (defaults to False for security). | |
| confirm_discard_unsaved | No | Explicit confirmation to discard any unsaved modifications in the active project. |