Files
EnglewoodLAB/SKILLS/unity-editor/assets-prefab-instantiate.md

4.5 KiB

name, description
name description
assets-prefab-instantiate Instantiates prefab in the current active scene. Use 'assets-find' tool to find prefab assets in the project.

Assets / Prefab / Instantiate

Instantiates prefab in the current active scene. Use 'assets-find' tool to find prefab assets in the project.

How to Call

HTTP API (Direct Tool Execution)

Execute this tool directly via the MCP Plugin HTTP API:

curl -X POST http://localhost:8080/api/tools/assets-prefab-instantiate \
  -H "Content-Type: application/json" \
  -d '{
  "prefabAssetPath": "string_value",
  "gameObjectPath": "string_value",
  "position": "string_value",
  "rotation": "string_value",
  "scale": "string_value",
  "isLocalSpace": false
}'

With Authorization (if required)

curl -X POST http://localhost:8080/api/tools/assets-prefab-instantiate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
  "prefabAssetPath": "string_value",
  "gameObjectPath": "string_value",
  "position": "string_value",
  "rotation": "string_value",
  "scale": "string_value",
  "isLocalSpace": false
}'

Input

Name Type Required Description
prefabAssetPath string Yes Prefab asset path.
gameObjectPath string Yes GameObject path in the current active scene.
position any No Transform position of the GameObject.
rotation any No Transform rotation of the GameObject. Euler angles in degrees.
scale any No Transform scale of the GameObject.
isLocalSpace boolean No World or Local space of transform.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "prefabAssetPath": {
      "type": "string",
      "description": "Prefab asset path."
    },
    "gameObjectPath": {
      "type": "string",
      "description": "GameObject path in the current active scene."
    },
    "position": {
      "$ref": "#/$defs/UnityEngine.Vector3",
      "description": "Transform position of the GameObject."
    },
    "rotation": {
      "$ref": "#/$defs/UnityEngine.Vector3",
      "description": "Transform rotation of the GameObject. Euler angles in degrees."
    },
    "scale": {
      "$ref": "#/$defs/UnityEngine.Vector3",
      "description": "Transform scale of the GameObject."
    },
    "isLocalSpace": {
      "type": "boolean",
      "description": "World or Local space of transform."
    }
  },
  "$defs": {
    "UnityEngine.Vector3": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        },
        "z": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y",
        "z"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "prefabAssetPath",
    "gameObjectPath"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/com.IvanMurzak.Unity.MCP.Runtime.Data.GameObjectRef",
      "description": "Find GameObject in opened Prefab or in the active Scene."
    }
  },
  "$defs": {
    "System.Type": {
      "type": "string"
    },
    "com.IvanMurzak.Unity.MCP.Runtime.Data.GameObjectRef": {
      "type": "object",
      "properties": {
        "instanceID": {
          "type": "integer",
          "description": "instanceID of the UnityEngine.Object. If it is \u00270\u0027 and \u0027path\u0027, \u0027name\u0027, \u0027assetPath\u0027 and \u0027assetGuid\u0027 is not provided, empty or null, then it will be used as \u0027null\u0027. Priority: 1 (Recommended)"
        },
        "path": {
          "type": "string",
          "description": "Path of a GameObject in the hierarchy Sample \u0027character/hand/finger/particle\u0027. Priority: 2."
        },
        "name": {
          "type": "string",
          "description": "Name of a GameObject in hierarchy. Priority: 3."
        },
        "assetType": {
          "$ref": "#/$defs/System.Type",
          "description": "Type of the asset."
        },
        "assetPath": {
          "type": "string",
          "description": "Path to the asset within the project. Starts with \u0027Assets/\u0027"
        },
        "assetGuid": {
          "type": "string",
          "description": "Unique identifier for the asset."
        }
      },
      "required": [
        "instanceID"
      ],
      "description": "Find GameObject in opened Prefab or in the active Scene."
    }
  },
  "required": [
    "result"
  ]
}