Set the current Selection in the Unity Editor to the provided objects. All `ObjectRef`s must resolve to existing Unity objects; otherwise the call throws. Use 'editor-selection-get' to inspect the current selection first.
Set the current Selection in the Unity Editor to the provided objects. All `ObjectRef`s must resolve to existing Unity objects; otherwise the call throws. Use 'editor-selection-get' to inspect the current selection first.
Editor / Selection / Set
Set the current Selection in the Unity Editor to the provided objects. Use 'editor-selection-get' tool to get the current selection first.
Inputs
select — array of ObjectRef. Every entry MUST resolve via FindObject(); otherwise the tool throws before touching Selection.objects.
Behavior
Assigns the resolved array to Selection.objects, then calls UnityEditorInternal.InternalEditorUtility.RepaintAllViews() so Hierarchy/Inspector reflect the change. Returns the post-change SelectionData snapshot.
If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead.
Read the /unity-initial-setup skill for detailed installation instructions.
Input
Name
Type
Required
Description
select
any
Yes
Input JSON Schema
{"type":"object","properties":{"select":{"$ref":"#/$defs/AIGD.ObjectRef-1"}},"$defs":{"AIGD.ObjectRef":{"type":"object","properties":{"instanceID":{"type":"integer","description":"instanceID of the UnityEngine.Object. If this is '0', then it will be used as 'null'."}},"required":["instanceID"],"description":"Reference to UnityEngine.Object instance. It could be GameObject, Component, Asset, etc. Anything extended from UnityEngine.Object."}
Output
Output JSON Schema
{"type":"object","properties":{"result":{"$ref":"#/$defs/AIGD.SelectionData"}},"$defs":{"AIGD.GameObjectRef-1":{"type":"array","items":{"$ref":"#/$defs/AIGD.GameObjectRef","description":"Find GameObject in opened Prefab or in the active Scene."}},"AIGD.GameObjectRef":{"type":"object","properties":{"instanceID":{"type":"integer"
,
"AIGD.ObjectRef-1"
:
{
"type"
:
"array"
,
"items"
:
{
"$ref"
:
"#/$defs/AIGD.ObjectRef"
,
"description"
:
"Reference to UnityEngine.Object instance. It could be GameObject, Component, Asset, etc. Anything extended from UnityEngine.Object."
}
}
}
,
"required"
:
[
"select"
]
}
,
"description"
:
"instanceID of the UnityEngine.Object. If it is '0' and 'path', 'name', 'assetPath' and 'assetGuid' is not provided, empty or null, then it will be used as 'null'. Priority: 1 (Recommended)"
}
,
"path"
:
{
"type"
:
"string"
,
"description"
:
"Path of a GameObject in the hierarchy Sample 'character/hand/finger/particle'. 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 'Assets/'"
}
,
"assetGuid"
:
{
"type"
:
"string"
,
"description"
:
"Unique identifier for the asset."
}
}
,
"required"
:
[
"instanceID"
]
,
"description"
:
"Find GameObject in opened Prefab or in the active Scene."
}
,
"System.Type"
:
{
"type"
:
"string"
}
,
"AIGD.ComponentRef-1"
:
{
"type"
:
"array"
,
"items"
:
{
"$ref"
:
"#/$defs/AIGD.ComponentRef"
,
"description"
:
"Component reference. Used to find a Component at GameObject."
}
}
,
"AIGD.ComponentRef"
:
{
"type"
:
"object"
,
"properties"
:
{
"index"
:
{
"type"
:
"integer"
,
"description"
:
"Component 'index' attached to a gameObject. The first index is '0' and that is usually Transform or RectTransform. Priority: 2. Default value is -1."
}
,
"typeName"
:
{
"type"
:
"string"
,
"description"
:
"Component type full name. Sample 'UnityEngine.Transform'. If the gameObject has two components of the same type, the output component is unpredictable. Priority: 3. Default value is null."
}
,
"instanceID"
:
{
"type"
:
"integer"
,
"description"
:
"instanceID of the UnityEngine.Object. If this is '0', then it will be used as 'null'."
}
}
,
"required"
:
[
"index"
,
"instanceID"
]
,
"description"
:
"Component reference. Used to find a Component at GameObject."
}
,
"System.Int32-1"
:
{
"type"
:
"array"
,
"items"
:
{
"type"
:
"integer"
}
}
,
"System.String-1"
:
{
"type"
:
"array"
,
"items"
:
{
"type"
:
"string"
}
}
,
"AIGD.ObjectRef"
:
{
"type"
:
"object"
,
"properties"
:
{
"instanceID"
:
{
"type"
:
"integer"
,
"description"
:
"instanceID of the UnityEngine.Object. If this is '0', then it will be used as 'null'."
}
}
,
"required"
:
[
"instanceID"
]
,
"description"
:
"Reference to UnityEngine.Object instance. It could be GameObject, Component, Asset, etc. Anything extended from UnityEngine.Object."
}
,
"AIGD.SelectionData"
:
{
"type"
:
"object"
,
"properties"
:
{
"GameObjects"
:
{
"$ref"
:
"#/$defs/AIGD.GameObjectRef-1"
,
"description"
:
"Returns the actual game object selection. Includes Prefabs, non-modifiable objects."
}
,
"Transforms"
:
{
"$ref"
:
"#/$defs/AIGD.ComponentRef-1"
,
"description"
:
"Returns the top level selection, excluding Prefabs."
}
,
"InstanceIDs"
:
{
"$ref"
:
"#/$defs/System.Int32-1"
,
"description"
:
"The actual unfiltered selection from the Scene returned as instance ids instead of objects."
}
,
"AssetGUIDs"
:
{
"$ref"
:
"#/$defs/System.String-1"
,
"description"
:
"Returns the guids of the selected assets."
}
,
"ActiveGameObject"
:
{
"$ref"
:
"#/$defs/AIGD.GameObjectRef"
,
"description"
:
"Returns the active game object. (The one shown in the inspector)."
}
,
"ActiveInstanceID"
:
{
"type"
:
"integer"
,
"description"
:
"Returns the instanceID of the actual object selection. Includes Prefabs, non-modifiable objects"
}
,
"ActiveObject"
:
{
"$ref"
:
"#/$defs/AIGD.ObjectRef"
,
"description"
:
"Returns the actual object selection. Includes Prefabs, non-modifiable objects."
}
,
"ActiveTransform"
:
{
"$ref"
:
"#/$defs/AIGD.ComponentRef"
,
"description"
:
"Returns the active transform. (The one shown in the inspector)."
