v0.7.0, For Godot >4.3

Node2D Gizmo adds gizmo functionality to EditorPlugins which subclass it, abstracting away the headaches that come with adding 2D gizmos to your editor interface. With Node2D Gizmo Just under 30 lines of code accomplish what would normally take several-hundred, re-implemented for each node.

Gizmos make editing and vizualizing your node's properties a breeze. Consider the example of an implementation of a cone-shaped area of effect. You or your team would like to be able to control the cone's extents visually, in the editor. But with no builtin equivalent to EditorNode3DGizmoPlugin, developers are left to implement their own solution for every such node.

EditorNode2DGizmoPlugin is a generalized EditorPlugin subclass, suitable to all Node2Ds. The Node2D Gizmo system handles all of the math and input to make adding gizmos fast and easy. To use in your own EditorPlugin, simply:

• Subclass EditorNode2DGizmoPlugin for the plugin script, and choose which Node property to control with a handle
• Write a function to infer a value for the property from a Handle's location around your node
• Write a function to infer the Handle's location from the property's value
• Finally, call add_handle().

Features

Easy to use!

Adjusting constants and thinking about vector math isn't for everyone. Using EditorNode2DGizmoPlugin can be as easy as writing a single function call.

Generalized and customizable

Handle behavior is parameterized. All of the math is taken care of

Draw in Global or Local Space

The blue knob is drawing in global space; the green knob is drawing in local space. The difference can be seen by scaling the viewport, rotating nodes in in the scene tree, and observing the results:

Before scaling and rotation:

After scaling and rotation:

IMPORTANT: Active Development

The interface should not be considered stable until v1.0.0. I developed it for a reason, and it is fully usable as-is. I intend to limit changes to the public interface as much as possible. But see the devlog for a road map -- some changes to the underlying architecture are inevitable.

The upshot of this is that I'll be continuing to maintain and update the class. Bug reports and feature requests are welcome. If you want to send me screenshots of the ways you've used EditorNode2DGizmoPlugin, I'd love to see those also!