# phantom-camera **Repository Path**: good-new-gitee/phantom-camera ## Basic Information - **Project Name**: phantom-camera - **Description**: 👻🎥 Control the movement and dynamically tween 2D & 3D cameras. Built for Godot 4. Inspired by Cinemachine. - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-09-13 - **Last Updated**: 2025-09-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: Godot ## README phantom-camera-readme-header

# What is it? Phantom Camera is a Godot 4 plugin designed to provide and simplify common behaviors for the built-in `Camera2D` and `Camera3D` nodes - heavily inspired by a Unity package called Cinemachine. It allows for simple behaviours such as following and looking at specific nodes, with an optional smooth/dampened movement, to more advance logic like reframing itself to keep multiple nodes in view and dynamically animate between specific camera positions, i.e. other `PhantomCamera` nodes, on demand. https://github.com/ramokz/phantom-camera/assets/5159399/2a900def-4a8b-46c2-976c-b8e66feec953

Documentation & Guides	Roadmap

### Showcases


(English) Phantom Camera For Godot Is Awesome! GameFromScratch	(Spanish) Mejores cámaras con Phantom Camera Bissash

(Portuguese) CÂMERA mais DINÂMICA com Phanton Camera Clécio Espindola GameDev	(English) The 4 MUST Have ADDONS for Godot 4 DevWorm

# Features

Priority

Determines which PhantomCamera should be active with the Camera2D/Camera3D.

When a new camera recieves a higher priority than currently active PhantomCamera the Camera2D/Camera3D will seamlessly transition to the new one.

Follow Mode

Define how the Camera2D/Camera3D should follow, or reposition based on, its target(s).

Glued

Sticks to its target.

Simple

Follows the target with an optional offset and damping.

2D	3D

Group

Follows the centre of a collection of targets.

2D	3D

Path

Follows a target while being positionally confined to a Path node.

2D	3D

Framed

Enables dynamic framing of a given target using dead zones. Dead zones enable the camera to remain still until the target moves far enough away from the camera's view. This is determined by the horizontal and vertical dead zone size in their respective properties within the inspector.

2D	3D

Third Person

As the name implies, this mode is meant to be used for third person camera experiences.
It works by applying a SpringArm3D node as a parent, where its properties, such as Collison Mask, Spring Length and Margin, can be adjusted from the PhantomCamera node.

2D	3D
Not available in 2D

Zoom (2D)

Define the Zoom level for the Camera2D.

2D	3D
	Not available in 3D

Look At (3D)

Defines where the Camera3D should be looking—adjusting its rotational value.

Mimic

Copies the rotational value of its target.

Simple

Looks At the target with an optional offset.

2D	3D
Not available in 2D

Group

Looks at the centre of a collection of targets.

2D	3D
Not available in 2D

Tween

Tweak how the Camera2d/Camera3D tweens to a newly active PhantomCamera.

2D	3D

Viewfinder

https://github.com/ramokz/phantom-camera/assets/5159399/6c9d1653-b4c6-4b5d-8855-402776645689 Preview what the `Camera2D` / `Camera3D` sees when attached to a PhantomCamera. Accessible from the bottom panel labelled `Phantom Camera`. The viewfinder rendering of the scene will only work when the combination of a `Camera`, `PhantomCameraHost` and `PhantomCamera` are present in the scene.

### 🪀 Example Scenes A 2D and 3D example scenes can be found inside `res://addons/phantom_camera/examples`. ## 💾 Installation ### Asset Library (Recommended - Stable) 1. In Godot, open the `AssetLib` tab. 2. Search for and select "Phantom Camera". 3. Download then install the plugin (be sure to only select the `phantom_camera` directory). 4. Enable the plugin inside `Project/Project Settings/Plugins`. ### Github Releases (Recommended - Stable) 1. Download a [release build](https://github.com/ramokz/phantom-camera/releases/). 2. Extract the zip file and move the `addons/phantom_camera` directory into the project root location. 3. Enable the plugin inside `Project/Project Settings/Plugins`. ### Github Main (Latest - Unstable) 1. Download the latest [`main branch`](https://github.com/ramokz/phantom-camera/archive/refs/heads/main.zip). 2. Extract the zip file and move the `addons/phantom_camera` directory into project's root location. 3. Enable the plugin inside `Project/Project Settings/Plugins`. For more help, see [Godot's official documentation](https://docs.godotengine.org/en/stable/tutorials/plugins/editor/installing_plugins.html) ## 📖 Roadmap See the [project page](https://github.com/users/ramokz/projects/3/views/8) for upcoming features. ## FAQ See the [FAQ page on the documentation site](https://phantom-camera.dev/support/faq). ## Contribution See the [contribution guidelines on the documentation site](https://phantom-camera.dev/support/how-to-contribute). ## Credits - [Unity's Cinemachine Package](https://unity.com/unity/features/editor/art-and-design/cinemachine) for the key inspiration - [Godot](https://godotengine.org/) for their amazing work creating the engine [MIT License](https://github.com/ramokz/phantom-camera/blob/main/LICENSE)