goutte / godot-trackball-camera

A Godot addon that adds a trackball camera node without gimbal lock.

Trackball Camera for Godot

A Godot 4.x addon that adds a TrackballCamera node without gimbal lock.

The TrackballCamera responds to input from mouse, keyboard, joystick and touch, in order to rotate around its parent node while facing it.

A version for Godot 3.x is available as well. A version for Godot 2.x is available as well.

Features

• stays around its parent node, even if the latter moves
• no gimbal lock (quaternions 🌟)
• camera inertia for a smoother experience (can be disabled)
• horizon can be stable or free
• the parent node does not have to be centered in the camera's view
• analog camera control with joystick, courtesy of @marcello505 (in #4)
• a bunch of parameters to configure everything as you want it
• one-click creation of camera actions (jams!)

Install

The installation is as usual, through the Assets Library. You can also simply copy the files of this project into yours, it should work.

Then, enable the plugin in Scene > Project Settings > Plugins.

Usage

Make the TrackballCamera a child of the Node3D to trackball around. Make sure your camera initially faces said node, and is at a proper distance from it. The initial position of your camera matters. The node does not need to be in the center of the camera's view.

You can also use this camera to look around you if you place it atop its parent node, spatially. It's going to rotate around itself, and that amounts to looking around. You'll probably want to set mouse_invert and keyboard_invert to true in that case.

Todo

• Test if touch works on android and html5, try SCREEN_DRAG otherwise. (see #6)

Feedback and contributions are welcome!