cinemachine-set-lens

Set lens fields on a CinemachineCamera's LensSettings in Unity scenes.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/PMK95/GridSquad --skill cinemachine-set-lens-pmk95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cinemachine-set-lens
Source: https://github.com/PMK95/GridSquad/tree/main/GridSquadUnity/.agents/skills/cinemachine-set-lens
Command: npx skills add https://github.com/PMK95/GridSquad --skill cinemachine-set-lens-pmk95

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Adjusting a Cinemachine virtual camera's lens properties in Unity normally requires manual editor work or custom scripts. This Skill lets you programmatically change field of view, orthographic size, clip planes, and Dutch angle on a CinemachineCamera through a single CLI call, modifying only the fields you specify. ## Core Features & Use Cases - Partial Lens Updates: Pass only the fields you want to change (FOV, orthographic size, near/far clip planes, Dutch angle); all other LensSettings remain untouched. - Editor Integration: Automatically marks the scene dirty and repaints the Unity Editor after applying changes, running entirely on the Unity main thread. - Use Case: While building a cutscene, you need to zoom a virtual camera from 60 to 35 degrees FOV and add a 5-degree Dutch tilt for dramatic effect. Call the tool with the GameObject reference and those two values, and the live camera updates immediately. ## Quick Start Ask the AI to set the field of view to 35 and the Dutch angle to 5 on the CinemachineCamera attached to your cutscene camera GameObject.

Frequently Asked Questions about cinemachine-set-lens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change the field of view of a Cinemachine virtual camera in Unity?▼

Call the cinemachine-set-lens tool with the gameObjectRef of the GameObject hosting the CinemachineCamera and the fieldOfView value in degrees. Only the fields you pass are modified; all other LensSettings stay unchanged.

How to set orthographic size on a CinemachineCamera via script?▼

Pass the orthographicSize parameter along with the gameObjectRef to the cinemachine-set-lens tool. The value represents the orthographic half-height and applies to orthographic cameras.

Does changing Cinemachine lens settings mark the Unity scene dirty?▼

Yes. The tool marks the scene dirty and repaints the Editor after writing the updated LensSettings, so your changes are preserved and visible immediately. The entire call runs on the Unity main thread.

What is the Dutch angle parameter on a Cinemachine camera?▼

Dutch is the roll angle of the camera in degrees, rotating the view around its forward axis. Pass the dutch parameter to cinemachine-set-lens to tilt the camera for dramatic or disorienting shot compositions.

Why is unity-mcp-cli not found when running the tool?▼

The unity-mcp-cli package is not installed globally. Install it with npm install -g unity-mcp-cli or prefix commands with npx unity-mcp-cli, then retry the run-tool call.