Skip to content

v5.0.0

Compare
Choose a tag to compare
@pkdawson pkdawson released this 30 Apr 19:45
· 99 commits to master since this release

imgui-all

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 to ImGuiGD.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.