mc_record_video
Capture a short video burst of the Minecraft client framebuffer to debug temporal rendering issues like animation glitches or shader bugs. Output as a grid or individual frames.
Instructions
Capture a short burst of the Minecraft client framebuffer for debugging temporal rendering issues — animation glitches, shader bugs, particles, sub-tick artifacts that mc_screenshot can't resolve. Use the Read tool to view the result.
Two output modes:
"grid" (default): one composed JPEG laid out as a frame grid. Best for Claude — the whole recording in a single Read.
"frames": N separate JPEGs. Use only when you need to inspect individual frames closely.
Caps (validated mod-side, request rejected if exceeded):
frames: 1..300 (≈5 s at 60 Hz)
interval: "frame" (every render tick) or milliseconds >= 1
downscale: integer >= 1 (default 2)
quality: [0.05, 1.0] (default 0.75)
Pick interval deliberately. Default to a numeric ms (50–100 ms is usually right) — smooth motion, never drops frames. Use "frame" only when sub-tick detail matters; at that cadence the encoder may fall behind and the response's "dropped" count tells you how many frames were skipped.
The mod and the MCP server must run on the same machine for the returned paths to be readable here. Files land under /debugbridge-recordings//.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| frames | Yes | Number of frames to capture, 1..300. Required. | |
| output | No | "grid" (one composed JPEG, default) or "frames" (N separate JPEGs). | |
| quality | No | JPEG quality in [0.05, 1.0]. Default 0.75. In "grid" mode applies once to the composed image. | |
| gridCols | No | Columns in grid layout. Default ceil(sqrt(frames)). Only used in "grid" mode. | |
| interval | No | "frame" for every render tick (~60 Hz), or milliseconds (number, >= 1). Default "frame". Recommended: 50–100 ms unless you specifically need sub-tick detail. | |
| downscale | No | Integer downscale factor. Default 2 (half each axis). |