create_instance
Create a single Roblox instance under a parent path in the edit copy, set its properties before parenting, and return its path as one undoable Studio step.
Instructions
Create one new instance in the edit copy and return its path. Recorded as one Studio undo step. A property that fails to set is skipped without an error, so read it back with get_properties when it matters. For several instances use create_tree (a nested hierarchy) or batch (mixed operations), which run in one call.
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": {
"className": "<className>",
"parentPath": "<parentPath>"
},
"name": "create_instance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the new instance. Defaults to the class name. | |
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| className | Yes | Roblox class to create, e.g. "Part", "Frame", "ModuleScript". Must be creatable with Instance.new. | |
| parentPath | Yes | Parent to create the instance under. Dot path from the DataModel root, e.g. "Workspace.Map.Door" or "StarterGui.HUD.Frame". A leading "game." is optional; a duplicate sibling name takes the suffix Tufan prints, e.g. "Part (2)". | |
| properties | No | Property name to value, applied before parenting. Write a primitive (string, number, boolean) or a typed wrapper: {Vector3:[x,y,z]}, {Color3:[r,g,b]} (0-1), {UDim2:[xScale,xOffset,yScale,yOffset]}, {CFrame:[x,y,z] or all 12 components}, {EnumItem:"Enum.Material.Wood"}, {BrickColor:"Bright red"}. |