mutate_instances
Modify Roblox instances by creating, deleting, cloning, moving, renaming, or pivoting them, with advanced options for batch operations and hierarchical structures.
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. | |
| 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. | |
| 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. | |
| spacing | No | [PRO] Spacing between duplicated instances. Used by: smart_duplicate. Alias for offset. |