capture_screenshot
Render a Godot scene statically and save the viewport as a PNG without launching the game. Use for previews or documentation captures.
Instructions
Render a scene file statically and save the viewport as a PNG. No running game needed. For live game captures, use game_screenshot or run_and_capture. Requires a display server.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectPath": "<projectPath>"
},
"name": "capture_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Override viewport width in pixels. Both width and height must be specified together. | |
| height | No | Override viewport height in pixels. Both width and height must be specified together. | |
| scenePath | No | Path to the scene file to capture (relative to project, e.g., "scenes/main.tscn"). If omitted, captures the project's main scene. | |
| outputPath | No | Path where the screenshot PNG will be saved. Defaults to "<projectPath>/screenshots/capture.png". | |
| waitFrames | No | Number of frames to wait before capturing (default: 3). Increase for scenes with loading animations or particle effects. | |
| projectPath | Yes | Path to the Godot project directory |