3D Cursor Plugin for Godot Engine

This plugin implements a 3D cursor in the Godot Engine, inspired by the 3D cursor functionality in Blender. It provides an intuitive way to place and position new nodes within a 3D scene, along with additional positioning tools.

Features

3D Cursor Placement: Use Shift + Right Click to place the 3D cursor in a 3D scene. The cursor appears only when clicking on a surface with a collider, ensuring accurate placement on interactable objects.
Node Placement at Cursor: New nodes inheriting from Node3D are automatically positioned at the cursor’s location instead of the scene or parent node’s origin. If the cursor is hidden, this functionality is disabled.
Cursor Persistence: If the cursor is deleted, it can be restored by pressing Shift + Right Click again. The cursor can also be manually adjusted using Godot's standard gizmos.
Additional Commands in the Command Palette:
- 3D Cursor to Origin: Resets the cursor's position to the scene origin.
- 3D Cursor to Selected Object: Moves the cursor to the position of a selected object or to the average position if multiple objects are selected.
Customizable Appearance:
- An optional label can be displayed with the cursor, with settings to scale it along with the cursor or keep it fixed.
- The cursor itself is scalable to fit different scene requirements.
Scene Compatibility: The cursor remains functional across different scenes. When placed in a new scene, it will be automatically removed from the previous one.

Activation Instructions

Note: Due to certain engine limitations, you must switch to a tab other than the 3D view (e.g., 2D, Script, or AssetLib) and then back to the 3D view once after enabling the plugin or upon engine startup to ensure full functionality.

Usage

Placing the Cursor: Press Shift + Right Click within a 3D scene to place the cursor on a collider surface. The cursor appears in the Node Tree and can be toggled visible or hidden.
Node Placement: When adding a new Node3D, it will be positioned at the cursor’s location if the cursor is visible.
Moving the Cursor: Use the following commands from the Command Palette (Ctrl + Shift + P):
- 3D Cursor to Origin: Resets the cursor to the origin of the scene.
- 3D Cursor to Selected Object(s): Aligns the cursor with the selected object(s).
- Selected Object to 3D Cursor: Aligns the selected object with the cursor.
- Remove 3D Cursor from Scene: Removes the cursor from the scene and freeing it.
New in v1.3.0:
- Pie Menu Improvement: If you keep pressing the shortcut for the Pie Menu (Shift + S) you can hover over the desired command and release the keys to invoke the command similar to Blender.
- Disable/Enable 3D Cursor: A command was added that allows the user to disable/enable the 3D Cursor within the active scene.
New in v1.2.0:
- The Pie Menu: This Pie Menu provides the same functionality as the command palette and is easier to reach. (Shift + S)
- Undo and Redo: Undo/Redo works as expected.
Customizing the Cursor: Adjust the cursor’s size and enable or disable the optional label via the Inspector. You can also configure the label to either scale with the cursor or remain fixed.

Version 1.3.0: Pie Menu Improvements

Pie Menu

This update introduces some imrprovements for the pie menu as well as some additional functionality for the 3D Cursor.

Selection Indicator: A new selection indicator in the pie menu that is pointing towards the mouse (purely aesthetic).
Pie Menu Background: A background container was added for the pie menu to increase the overall contrast especially in bright scenes.
Disable/Enable 3D Cursor Command: A new command was added in the pie menu as well as the command palette. This command allows to quickly toggle the 3D Cursor of the active scene on or off.
Undo/Redo for Cursor positioning: If the user sets the position of the 3D Cursor via Shift + Right Click, this action can now be undone via Ctrl + Z.
Hover and Release to select: If the user keeps pressing the shortcut for the pie menu (Shift + S) and then hovers over a button, he can then release the keys to select the hovered command (similar to Blender).
Tested and working in 4.2: The plugin is now tested and usable in Godot 4.2 and above. Versions below are unsupported at the moment (Changes to the EditorPlugin class made in 4.2 are required).

Version 1.2.0: Pie Menu and Undo-Redo Update

Pie Menu

This update introduces a Pie Menu similar to Blender's, accessible via Shift + S. This menu provides quicker access to commands also found in the Command Palette, allowing for a faster workflow.

Additionally, Undo and Redo functionality has been added, allowing most cursor actions to be undone/redone. The exception is the Remove 3D Cursor from Scene command, as it frees the cursor object itself and thus cannot be undone.

Installation

Download or clone the repository into your Godot project’s addons folder or download the plugin via the AssetLib in the engine.
Enable the 3D Cursor Plugin in Project > Project Settings > Plugins.

3D Cursor
Command Palette Actions