com.IvanMurzak.Godot.MCP.PhantomCamera 1.1.3

dotnet add package com.IvanMurzak.Godot.MCP.PhantomCamera --version 1.1.3
                    
NuGet\Install-Package com.IvanMurzak.Godot.MCP.PhantomCamera -Version 1.1.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="com.IvanMurzak.Godot.MCP.PhantomCamera" Version="1.1.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="com.IvanMurzak.Godot.MCP.PhantomCamera" Version="1.1.3" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.Godot.MCP.PhantomCamera" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add com.IvanMurzak.Godot.MCP.PhantomCamera --version 1.1.3
                    
#r "nuget: com.IvanMurzak.Godot.MCP.PhantomCamera, 1.1.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package com.IvanMurzak.Godot.MCP.PhantomCamera@1.1.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=com.IvanMurzak.Godot.MCP.PhantomCamera&version=1.1.3
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.Godot.MCP.PhantomCamera&version=1.1.3
                    
Install as a Cake Tool

PhantomCamera Tools

RQL module for the Godot Phantom Camera addon: a phantomcamera source that lists virtual cameras and hosts with their modes by name, and validated SetFollow / SetLookAt calls.

Optional Godot-MCP extension, independently versioned as NuGet package com.IvanMurzak.Godot.MCP.PhantomCamera. Requires a Godot C# project (4.4.0+) with a core godot_mcp addon that has the RQL tools (rql-query / rql-mutate / rql-schema, the release after 0.28.0).

Required prerequisite — Phantom Camera (install it yourself)

This extension does NOT include the Phantom Camera addon and does not download or vendor it. You must install Phantom Camera into your own Godot project separately:

Without Phantom Camera installed and enabled, phantomcamera | select installed hint reports false with an install hint and the phantomcamera lists are empty (by design).

Phantom Camera is © its authors and distributed under the MIT License. This extension is not affiliated with, endorsed by, or sponsored by the Phantom Camera project — it merely provides an RQL module that drives it. See the addon's own repository for its licence and terms.

Install

godot-cli install-plugin /path/to/project
godot-cli install-extension com.IvanMurzak.Godot.MCP.PhantomCamera /path/to/project
godot-cli build /path/to/project

The installer resolves the latest stable version from NuGet; use --version <x.y.z> to request an exact version. Packages contain C# source and build props, compiled against the project's own GodotSharp. Previous NuGet versions remain installable after the repository migration.

RQL

Since 1.0.0 the extension is an RQL module: it adds no MCP tools. Agents set up and read virtual cameras with the core rql-query / rql-mutate / rql-schema tools, and the module's guide is part of the core godot-rql skill. Phantom Camera classes are GDScript class_names (no C# type; class shows the native base Node3D / Node2D), so the module adds:

  • The phantomcamera source: installed, hint (how to install the addon when it is missing), and the addon's nodes in the edited scene as read-only rows: phantomcamera.cameras (name path scriptClass priority followMode followTarget lookAtMode lookAtTarget followDamping lookAtDamping node, modes by name) and phantomcamera.hosts (name path camera node).
  • Writes go through the row's node (get node | set props["priority"] = 50): the core's writes, undoable, mark the scene unsaved. Cameras, hosts and the Camera3D are created with the core AddChild.
  • Validated mode calls on a camera row: SetFollow(mode, target?) and SetLookAt(mode, target?) take the mode by name and set the target after it (the addon silently ignores a target set while the mode is None). An unknown mode, ThirdPerson / look-at on a PhantomCamera2D, a single target for None / Group, or a target of the wrong dimension fails and changes nothing. They are calls on the row, not on the node, so they are not undoable (they mark the scene unsaved themselves); the undoable alternative is get node | set props["follow_mode"] = 2, ….
phantomcamera | select installed hint
root | call AddChild("Camera3D", "Camera3D")
godot.find("Camera3D") | call AddChild("PhantomCameraHost", "PhantomCameraHost")
root | call AddChild("Node3D", "Player")
root | call AddChild("PhantomCamera3D", "PCam")
phantomcamera.cameras | where name == "PCam" | call SetFollow("Simple", "Player")
phantomcamera.cameras | where name == "PCam" | call SetLookAt("Simple", "Player")
phantomcamera.cameras | where name == "PCam" | get node | set props["priority"] = 50, props["follow_damping"] = true
phantomcamera.cameras | select name scriptClass priority followMode followTarget lookAtMode lookAtTarget followDamping
phantomcamera.hosts | select name path camera

Without the addon the module still loads: phantomcamera | select installed hint returns false and the install hint, and the lists are empty. Save the scene with editor | call SaveScene().

Migrating from 0.x

0.x tool RQL
phantomcamera-defaults removed: the guide lists typical values (priority 10, follow / look-at mode Simple, damping on)
phantomcamera-host-create rql-mutate root \| call AddChild("Camera3D", "Camera3D"), then godot.find("Camera3D") \| call AddChild("PhantomCameraHost", "PhantomCameraHost")
phantomcamera-create rql-mutate root \| call AddChild("PhantomCamera3D", "PCam"), then … \| get node \| set props["priority"] = 20
phantomcamera-set-follow rql-mutate phantomcamera.cameras \| where name == "PCam" \| call SetFollow("Simple", "Player")
phantomcamera-set-look-at rql-mutate phantomcamera.cameras \| where name == "PCam" \| call SetLookAt("Simple", "Player")
phantomcamera-set-priority rql-mutate phantomcamera.cameras \| where name == "PCam" \| get node \| set props["priority"] = 50
phantomcamera-get rql-query phantomcamera.cameras \| select name priority followMode followTarget lookAtMode lookAtTarget
Installed: false results phantomcamera \| select installed hint

Development and releases

See the monorepo test and release guide. This module retains its own package, version, tests and Apache-2.0 license. Releasing another module does not rebuild or republish this package.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.3 57 11/19/2026
1.1.2 320 11/14/2026
1.1.1 389 11/7/2026
1.1.0 160 10/31/2026
1.0.1 148 10/24/2026
1.0.0 158 10/18/2026
0.1.2 144 10/16/2026
0.1.1 160 10/12/2026
0.1.0 486 6/29/2026