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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
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)."
