v5.0.0
To enable various new features, this plugin now includes native GDExtension binaries. This is optional, so you can continue to use the pure C# implementation if you want a smaller plugin without these features.
Compatibility changes
These are the new minimum requirements for imgui-godot. If you need to use older stuff, you can continue to use the 4.x
branch. It won't receive new features, but I'll fix any reported bugs.
- Godot 4.2
- .NET 8
API changes
ImGuiLayer
is no longer part of the public API. Use ImGuiGD.Connect(...)
and ImGuiGD.Visible
instead.
A few things were removed from ImGuiGD
because they should have only been used internally anyway.
New GDExtension features
- Partial support for GDScript
- Supports C++ modules
- Supports C++ GDExtensions
- In-editor GUI with tool scripts
- FreeType font rendering
New universal features
- Add optional
glyphRanges
parameter toImGuiGD.AddFont
GDScript
The GDScript bindings for ImGui are based on the official dear_bindings
. It covers most of the API, but for now excludes some of the more complicated stuff like table sorting. If there's a specific feature you need that isn't working, please file an issue.
Notes
This is a huge update with a ton of new code, so there are probably some bugs I still haven't found. The documentation and examples need some work as well. Please submit an issue if you encounter any trouble.
Note
The filename of the full package (with GDExtension) includes the version of ImGui it was built with. It's very important to use a matching version of ImGui.NET, or your game will crash. This will always be the latest version of ImGui.NET at the time of release, and I will try to quickly release new packages shortly after ImGui.NET is updated.