Agent SkillsIvanMurzak/Unity-MCP › screenshot-camera

screenshot-camera

GitHub

从Unity相机捕获屏幕截图并返回PNG图像,供LLM进行视觉检查。支持指定相机引用及分辨率,自动回退至主相机,便于游戏场景调试与审查。

Unity-MCP-Plugin/.claude/skills/screenshot-camera/SKILL.md IvanMurzak/Unity-MCP

Trigger Scenarios

需要查看Unity游戏场景当前画面时 调试UI或摄像机渲染问题时

Install

npx skills add IvanMurzak/Unity-MCP --skill screenshot-camera -g -y
More Options

Non-standard path

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

Use without installing

npx skills use IvanMurzak/Unity-MCP@screenshot-camera

指定 Agent (Claude Code)

npx skills add IvanMurzak/Unity-MCP --skill screenshot-camera -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": "screenshot-camera",
    "description": "Capture a screenshot from a Unity `Camera` and return it as a PNG image for direct LLM inspection. Falls back to `Camera.main` (then any active camera) when `cameraRef` is null. Width and height are capped to keep response size manageable."
}

Screenshot / Camera

Captures a screenshot from a camera and returns it as an image. If no camera is specified, uses the Main Camera. Returns the image directly for visual inspection by the LLM.

Inputs

  • cameraRef (optional) — reference to a GameObject hosting a Camera. When null, Camera.main is used; if there is no main camera, the first entry of Camera.allCameras is used.
  • width (default 1920) / height (default 1080) — output pixels. Must be > 0 and ≤ MaxDimension.

Behavior

Allocates a temporary RenderTexture, swaps it onto the chosen camera, calls Camera.Render, reads back via Texture2D.ReadPixels, encodes as PNG, and restores the camera's prior targetTexture. Returns a ResponseCallTool.Image with image/png MIME and a descriptive caption.

How to Call

unity-mcp-cli run-tool screenshot-camera --input '{
  "cameraRef": "string_value",
  "width": 0,
  "height": 0
}'

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

unity-mcp-cli run-tool screenshot-camera --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool screenshot-camera --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
cameraRef any No Reference to the camera GameObject. If not specified, uses the Main Camera.
width integer No Width of the screenshot in pixels.
height integer No Height of the screenshot in pixels.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "cameraRef": {
      "$ref": "#/$defs/AIGD.GameObjectRef"
    },
    "width": {
      "type": "integer"
    },
    "height": {
      "type": "integer"
    }
  },
  "$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."
    }
  }
}

Output

This tool does not return structured output.

Version History

  • 0.86.1 Current 2026-07-25 08:52

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-destroy/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.90.0
Hash
38f24e7d
Indexed
2026-07-25 08:52

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-17 08:16
浙ICP备14020137号-1