Agent SkillsIvanMurzak/Unity-MCP › gameobject-destroy

gameobject-destroy

GitHub

在Unity编辑器中递归销毁指定GameObject及其子节点,返回销毁对象的名称、路径和实例ID用于确认。需先使用gameobject-find定位目标。

Unity-MCP-Plugin/.claude/skills/gameobject-destroy/SKILL.md IvanMurzak/Unity-MCP

Trigger Scenarios

需要删除场景或Prefab中的特定游戏对象 清理不再需要的层级结构

Install

npx skills add IvanMurzak/Unity-MCP --skill gameobject-destroy -g -y
More Options

Non-standard path

npx skills add https://github.com/IvanMurzak/Unity-MCP/tree/main/Unity-MCP-Plugin/.claude/skills/gameobject-destroy -g -y

Use without installing

npx skills use IvanMurzak/Unity-MCP@gameobject-destroy

指定 Agent (Claude Code)

npx skills add IvanMurzak/Unity-MCP --skill gameobject-destroy -a claude-code -g -y

安装 repo 全部 skill

npx skills add IvanMurzak/Unity-MCP --all -g -y

预览 repo 内 skill

npx skills add IvanMurzak/Unity-MCP --list

SKILL.md

Frontmatter
{
    "name": "gameobject-destroy",
    "description": "Destroy a GameObject (and all nested children) in the currently opened Prefab or active Scene. Returns the destroyed GameObject's name, path, and instance ID for confirmation. Use 'gameobject-find' to locate the target first."
}

GameObject / Destroy

Destroy GameObject and all nested GameObjects recursively in opened Prefab or in a Scene. Use 'gameobject-find' tool to find the target GameObject first.

Behavior

Validates the gameObjectRef, resolves it on the main thread, then calls Object.DestroyImmediate (the immediate variant is required for Editor-mode operations). Returns a DestroyGameObjectResult containing DestroyedName, DestroyedPath, and DestroyedInstanceId so the caller has a record of what was removed.

How to Call

unity-mcp-cli run-tool gameobject-destroy --input '{
  "gameObjectRef": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool gameobject-destroy --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool gameobject-destroy --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

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
gameObjectRef any Yes Find GameObject in opened Prefab or in the active Scene.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "gameObjectRef": {
      "$ref": "#/$defs/AIGD.GameObjectRef"
    }
  },
  "$defs": {
    "System.Type": {
      "type": "string"
    },
    "AIGD.GameObjectRef": {
      "type": "object",
      "properties": {
        "instanceID": {
          "type": "integer",
          "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."
    }
  },
  "required": [
    "gameObjectRef"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "$ref": "#/$defs/AIGD.DestroyGameObjectResult"
    }
  },
  "$defs": {
    "AIGD.DestroyGameObjectResult": {
      "type": "object",
      "properties": {
        "DestroyedName": {
          "type": "string",
          "description": "Name of the destroyed GameObject."
        },
        "DestroyedPath": {
          "type": "string",
          "description": "Hierarchy path of the destroyed GameObject."
        },
        "DestroyedInstanceId": {
          "type": "integer",
          "description": "Instance ID of the destroyed GameObject."
        }
      },
      "required": [
        "DestroyedInstanceId"
      ]
    }
  },
  "required": [
    "result"
  ]
}

Version History

  • 0.86.1 Current 2026-07-25 08:51

Same Skill Collection

.claude/skills/build-cli/SKILL.md
.claude/skills/github-pr-review-fix/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-copy/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-create-folder/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-delete/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-find-built-in/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-find/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-get-data/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-material-create/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-modify/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-move/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-prefab-close/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-prefab-create/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-prefab-instantiate/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-prefab-open/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-prefab-save/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-refresh/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-shader-get-data/SKILL.md
Unity-MCP-Plugin/.claude/skills/assets-shader-list-all/SKILL.md
Unity-MCP-Plugin/.claude/skills/console-clear-logs/SKILL.md
Unity-MCP-Plugin/.claude/skills/console-get-logs/SKILL.md
Unity-MCP-Plugin/.claude/skills/editor-application-get-state/SKILL.md
Unity-MCP-Plugin/.claude/skills/editor-application-set-state/SKILL.md
Unity-MCP-Plugin/.claude/skills/editor-selection-get/SKILL.md
Unity-MCP-Plugin/.claude/skills/editor-selection-set/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-component-add/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-component-destroy/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-component-get/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-component-list-all/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-component-modify/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-create/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-duplicate/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-find/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-modify/SKILL.md
Unity-MCP-Plugin/.claude/skills/gameobject-set-parent/SKILL.md
Unity-MCP-Plugin/.claude/skills/object-get-data/SKILL.md
Unity-MCP-Plugin/.claude/skills/object-modify/SKILL.md
Unity-MCP-Plugin/.claude/skills/package-add/SKILL.md
Unity-MCP-Plugin/.claude/skills/package-list/SKILL.md
Unity-MCP-Plugin/.claude/skills/package-remove/SKILL.md
Unity-MCP-Plugin/.claude/skills/package-search/SKILL.md
Unity-MCP-Plugin/.claude/skills/ping/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-capture-frame/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-clear-data/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-enable-module/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-get-memory-stats/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-get-rendering-stats/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-get-script-stats/SKILL.md
Unity-MCP-Plugin/.claude/skills/profiler-get-status/SKILL.md

Metadata

Files
0
Version
0.88.0
Hash
09c45294
Indexed
2026-07-25 08:51

inicio - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-22 05:03
浙ICP备14020137号-1 $mapa de visitantes$