create_prim
Creates a USD prim at a given path—shape, Xform, camera, light, or file reference—with optional transforms and physics.
Instructions
Create a prim at prim_path: a shape, an Xform, a camera, a light or any USD type, or a reference to a file.
prim_type is a USD type name: Cube, Sphere, Cylinder, Cone, Capsule, Xform, Camera, DistantLight, DomeLight, SphereLight and the rest. Missing parents are made as typeless prims. A prim already at prim_path keeps its type: one of another type is refused, one of the same type takes the new transform, written as set_prim_transform writes it. A transform it can't write makes nothing. A usd_path file whose upAxis, metersPerUnit or kilogramsPerUnit isn't the stage's is brought to the stage as create_robot brings a robot file: turned upright, scaled, its physics values converted, and the answer says so; one that authors none is left as it is. usd_path adds its reference to a prim already there as the file is. A file that can't be opened is an error. enable_physics puts the RigidBody and Collision APIs on the prim itself, so a shape falls and collides while the simulation plays; the meshes under an Xform or a referenced file's root get no Collision API of their own: give each one with set_physics_properties' collision=True, which makes a static collider without a rigid body. To copy a prim, use clone_prim; for a robot, create_robot.
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": {
"prim_path": "<prim_path>"
},
"name": "create_prim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | A uniform scale, or [sx, sy, sz] | |
| position | No | [x, y, z] relative to the parent prim, in the stage's units (get_sim_state's meters_per_unit) | |
| rotation | No | Euler angles [rx, ry, rz] in degrees, or a quaternion [w, x, y, z] | |
| usd_path | No | A USD file to reference instead of a type: an absolute path on Kit's machine, or a URL | |
| prim_path | Yes | Where to create it, e.g. "/World/MyCube" | |
| prim_type | No | USD type name, e.g. Cube, Sphere, Xform, DistantLight | Xform |
| enable_physics | No | Add the RigidBody and Collision APIs |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |