clone_prim
Copy a USD prim and all its children to a new path, optionally creating multiple copies spaced by an offset in the parent space.
Instructions
Copy a prim with everything under it to a new path, once or as a row of count copies.
The first copy sits on the source and each next one moves by offset from the one before, so a single copy is never moved: move it with set_prim_transform. With offset, copy n moves n times offset from the source in the parent's space, through its own translate op or matrix, its other ops and placement kept; the first copy, and a single copy, are left as copied. A source whose position can't be written copies nothing. It copies what the stage's root layer holds at source_path, its references included, so a prim from a sublayer, or from inside a referenced asset, can't be copied whole. A target path that already holds a prim is refused before anything is copied. For a new prim, use create_prim.
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": {
"source_path": "<source_path>",
"target_path": "<target_path>"
},
"name": "clone_prim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many copies: one goes to target_path, more to target_path_001, _002, ... | |
| offset | No | [x, y, z] in the parent's space: each copy after the first sits this far from the last | |
| source_path | Yes | The prim to clone, e.g. "/World/MyCube" | |
| target_path | Yes | Where the copy goes, e.g. "/World/MyCube_Copy" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |