mutate_instances
Create, delete, clone, move, rename, or pivot Roblox instances. Supports batch operations for efficient editing.
Instructions
Create, delete, clone, move, rename, or pivot instances. [PRO] create_tree, mass_create, mass_delete, mass_duplicate, smart_duplicate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Mutation action. Basic: create, create_with_props, delete, clone, move, rename, pivot. [PRO]: create_tree, mass_create, mass_delete, mass_duplicate, smart_duplicate. | |
| contextId | No | Optional execution context identifier. Used to continue an existing context for mutating actions. | |
| contextSummary | No | Optional structured execution context attached to this tool call. | |
| replayMetadata | No | Optional replay-ready metadata attached to this tool call. | |
| className | No | Roblox class name (e.g., Part, Script, Folder). Used by: create, create_with_props. | |
| parent | No | Parent path for new instance. Used by: create, create_with_props. | |
| name | No | Name for the instance. Used by: create (optional), create_with_props (required). | |
| properties | No | Properties to set on the instance. Supports Vector3, Color3, CFrame, UDim2, Enum types. Used by: create (optional), create_with_props (required). | |
| path | No | Instance path to operate on. Used by: delete, clone (as sourcePath), move, rename, pivot, smart_duplicate. | |
| sessionDebugId | No | Optional same Studio/plugin session debug identity for verifying a duplicate-named target. Used by: delete, clone, move, rename, pivot, smart_duplicate. | |
| siblingIndex | No | Optional 1-based same-name sibling index fallback for verifying a duplicate-named target. Used by: delete, clone, move, rename, pivot, smart_duplicate. | |
| sourcePath | No | Source instance path to clone from. Used by: clone. Alternative to path. | |
| targetParent | No | Target parent for cloned/duplicated instances. Used by: clone, mass_duplicate, smart_duplicate. | |
| newName | No | New name for instance. Used by: rename (required), clone (optional). | |
| newParent | No | New parent path to move instance to. Used by: move. | |
| position | No | Target position as Vector3 {x, y, z}. Used by: pivot. | |
| cframe | No | Target CFrame as 12-number array [x, y, z, r00, r01, r02, r10, r11, r12, r20, r21, r22]. Used by: pivot. | |
| offset | No | Relative offset to move by (ignores position/cframe). Used by: pivot, smart_duplicate. | |
| tree | No | [PRO] Instance tree specification for hierarchical creation. Used by: create_tree. | |
| instances | No | [PRO] Array of instance specifications for batch creation. Used by: mass_create. Each item: {className, name, parentPath, properties?}. | |
| paths | No | [PRO] Array of instance paths. Used by: mass_delete, mass_duplicate. | |
| count | No | [PRO] Number of copies to create. Used by: smart_duplicate. |