v0.8.0, For Godot 4.5

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
• Call add_handle().

Users can also add handles directly, using the editor interface to set properties as desired. It's a lot easier, frankly. Check out the video for an example.

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, especially since v0.8.0.

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!

Known Issues

Feel free to report bugs, make feature requests, or ask about how to do something with this tool. Here is a list of issues I know about, as of February 16th, 2026:

• BLOCKING: The handles don't take skew into account at all! They entirely break when you skew a node.
• There's currently no minimum size for labels; text scales poorly in general
• Certain warnings related to is_antialiased and is_filled are not always shown.
• Fonts might not work quite right?