Manage Camera
manage_cameraCreate, configure, and control cameras in Unity. Supports basic Camera and Cinemachine for flexible camera management, including setup, targets, priorities, lens, body, aim, and screenshots.
Instructions
Manage cameras (Unity Camera + Cinemachine). Works without Cinemachine using basic Camera; unlocks presets, pipelines, and blending when Cinemachine is installed. Use ping to check Cinemachine availability.
SETUP:
ping: Check if Cinemachine is available
ensure_brain: Ensure CinemachineBrain exists on main camera
get_brain_status: Get Brain state (active camera, blend, etc.)
CAMERA CREATION:
create_camera: Create camera with preset (third_person, freelook, follow, dolly, static, top_down, side_scroller). Falls back to basic Camera without Cinemachine.
CAMERA CONFIGURATION:
set_target: Set Follow and/or LookAt targets on a camera
set_priority: Set camera priority for Brain selection
set_lens: Configure lens (fieldOfView, nearClipPlane, farClipPlane, orthographicSize, dutch)
set_body: Configure Body component (bodyType to swap, plus component properties)
set_aim: Configure Aim component (aimType to swap, plus component properties)
set_noise: Configure Noise component (amplitudeGain, frequencyGain)
EXTENSIONS:
add_extension: Add extension (extensionType: CinemachineConfiner2D, CinemachineDeoccluder, CinemachineImpulseListener, CinemachineFollowZoom, CinemachineRecomposer, etc.)
remove_extension: Remove extension by type
CAMERA CONTROL:
set_blend: Configure default blend (style: Cut/EaseInOut/Linear/etc., duration)
force_camera: Override Brain to use specific camera
release_override: Release camera override
list_cameras: List all cameras with status
CAPTURE:
screenshot: Capture a screenshot. By default (no camera specified) uses ScreenCapture API, which captures all render layers including Screen Space - Overlay UI canvases. Specifying a camera uses direct camera rendering, which EXCLUDES Screen Space - Overlay canvases (use only when you need a specific viewpoint without UI). Supports include_image=true for inline base64 PNG, batch='surround' for 6-angle contact sheet, batch='orbit' for configurable grid, view_target/view_position for positioned capture, and capture_source='scene_view' to capture the active Unity Scene View viewport.
screenshot_multiview: Shorthand for screenshot with batch='surround' and include_image=true.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batch | No | Batch capture mode: 'surround' (6 angles) or 'orbit' (configurable grid). | |
| action | Yes | The camera action to perform. | |
| camera | No | Camera to capture from (name, path, or instance ID). Omit to use ScreenCapture API (captures all layers including Screen Space Overlay UI). Specify only when you need a particular camera viewpoint; note that Screen Space - Overlay canvases will NOT appear in camera-rendered captures. | |
| target | No | Target camera (name, path, or instance ID). | |
| orbit_fov | No | Camera FOV in degrees for batch='orbit' (default 60). | |
| properties | No | Action-specific parameters (dict or JSON string). | |
| view_target | No | Target to focus on. GameObject name/path/ID or [x,y,z]. For game_view: aims camera at target. For scene_view: frames the Scene View on the target. | |
| orbit_angles | No | Number of azimuth samples for batch='orbit' (default 8, max 36). | |
| include_image | No | If true, return screenshot as inline base64 PNG. Default false. | |
| output_folder | No | Optional folder for screenshot output. Project-relative (e.g. 'Assets/Screenshots' or 'Captures') or absolute path inside the project. Overrides the user's Editor preference. If omitted, falls back to the Editor preference, then to the built-in default (Assets/Screenshots). | |
| search_method | No | How to find target. | |
| view_position | No | World position [x,y,z] to place camera for positioned capture. | |
| view_rotation | No | Euler rotation [x,y,z] for camera. Overrides view_target if both provided. | |
| capture_source | No | Screenshot source. 'game_view' (default) captures the game/camera path; 'scene_view' captures the active Unity Scene View viewport. | |
| max_resolution | No | Max resolution (longest edge px) for inline image. Default 640. | |
| orbit_distance | No | Camera distance from target for batch='orbit' (default auto). | |
| orbit_elevations | No | Elevation angles in degrees for batch='orbit' (default [0, 30, -15]). | |
| screenshot_file_name | No | Screenshot file name (optional). Defaults to timestamp. | |
| screenshot_super_size | No | Screenshot supersize multiplier (integer >= 1). |