load_scene
Open a Houdini hip file or merge specific nodes into the current scene, restoring set variables and reporting load warnings, conflicts, and merged nodes.
Instructions
Open a Houdini hip file, or merge it — or named nodes from it — into the current scene.
Load warnings (missing assets and the like) come back in warnings.
A merge reports what arrived: merged_nodes, conflicts (a node that
already exists is merged under a new name, or overwritten in place with
overwrite_on_conflict=True) and not_found_in_file. node_paths are
absolute (/obj/building_v3) and bring their contents. A merge keeps
the scene's set -g variables ($JOB, $POSE) the file would overwrite,
named in globals_restored with the file's value and the kept one;
variables the file adds are listed in globals_added.
Args: file_path: Path to the hip file to open; $JOB, $HIP and other variables are expanded. merge: Merge into the current scene instead of replacing it. node_paths: With merge, the absolute node paths to merge; default everything. overwrite_on_conflict: With merge, overwrite same-named nodes instead of renaming the merged copy.
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": {
"file_path": "<file_path>"
},
"name": "load_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| merge | No | ||
| file_path | Yes | ||
| node_paths | No | ||
| overwrite_on_conflict | No |