After refining our Godot 3.2 release with bug fixes in 3.2.1 last month, it’s time to integrate some of the new features that didn’t make it into the 3.2 merge window but have been further developed and backported since.

Notably, Godot 3.2.2 is going to add three major features:

We need your help to test and validate these changes before publishing 3.2.2-stable, which is why we publish this beta build now. If you find any new issue with this build, especially related to one of the listed big changes, please report it on GitHub, ideally including a minimal project that can be used to reproduce the issue.

How to test

It should be safe to test this build directly with pre-existing projects made with Godot 3.2.x. It’s of course always advised to use a version control system or backups in case you want to go back to the previous version (but testing 3.2.2-beta1 shouldn’t prevent you from doing so anyway).

C# support for iOS

C# support for iOS should work similarly to exporting a GDScript project for iOS. Note that the export needs to be done from a macOS system to use the included AOT compiler for iOS arm64. If you run into any issue with the export process, please also test the export of a simple GDScript project to verify if the issue relates to the new C# support or to the iOS export pipeline in general.

GLES2 2D batching

The new 2D batching is only implemented for the GLES2 renderer, so if you use GLES3 you will not be able to benefit from it. As the GLES3 renderer is being deprecated by Vulkan in Godot 4.0, we currently don’t plan to port the 2D batching to it. GLES2 batching is enabled by default both in-game and in the editor. You can turn it off or configure advanced settings in the Project Settings. Please see this dedicated issue for more details and to share your own testing results (we’re interested in all feedback, whether you gained a lot of performance, lost some or didn’t notice any chance). Note that currently, only rects are batched (TileMaps, draw_rect, text rendering, etc.), but we plan to include more primitive types once this has been well tested.

New Android plugin system

Godot 3.2 came with a brand new Android plugin system already, and notably the possibility to build custom APKs from your project folder with any additional plugins/modules that your project needs.

Fredia had done a lot of work back then to improve Juan’s initial custom build system, which led him to notice many things that could be modernized to be better suited to the current Android ecosystem. Notably, he re-architectured the plugin system to leverage the Android AAR library file format.

This new plugin system is backward-incompatible with the 3.2/3.2.1 system, but both systems are kept functional in future releases of the 3.2.x branch. Since we previously did not version our Android plugin systems, this new one is now labelled v1, and is the starting point for the modern Godot Android ecosystem.

See this Pull Request and the updated documentation for details. Fredia has already started helping some plugin authors to update theirs to the new v1 system, feel free to ask if you need help too.

Other changes

Apart from those three major features, there are also close to 200 cherry-picks for bug fixes and enhancements which have been merged since Godot 3.2.1. Here are some highlights:

  • Android: Re-architecture of the Godot Android plugin (GH-36336).
  • Android: Add signal support to Godot Android plugins (GH-37305).
  • AStar: Implements estimate/compute_cost for AStar2D (GH-37039).
  • Audio: Fix volume interpolation in positional audio nodes (GH-37279).
  • Core: Ensure COWData does not always reallocate on resize (GH-37373).
  • Editor: Add rotation widget to 3D viewport (GH-33098).
  • C#: Add iOS support (GH-36979).
  • C#: Sync csproj when files are changed from the FileSystem dock (GH-37149).
  • C#: Replace uses of old Configuration and update old csprojs (GH-36865).
  • Files: Allow specify unpack location when loading a .pck (GH-35261).
  • Files: Improve UX of drive letters (GH-36639).
  • GLES2: Add 2D batch rendering across items (GH-37349).
  • GLES2: Avoid material rebind when using skeleton (GH-37667).
  • GLES2/GLES3: Add support for OpenGL external textures (GH-36342).
  • GLES2/GLES3: Reset texture flags after radiance map generation (GH-37815).
  • Import: Fix changing the import type of multiple files at once (regression fix) (GH-37610).
  • Language Server: Switch the GDScript LSP from WebSocket to TCP, compatible with more external editors (GH-35864).
  • macOS: Ignore process serial number argument passed by macOS Gatekeeper (GH-37719).
  • Object: Add has_signal method (GH-33508).
  • Skeleton: Fix IK rotation issue (GH-37272).
  • VR: Fix aspect ratio on HMD projection matrix (GH-37601).
  • Windows: Make stack size on Windows match Linux and macOS (GH-37115).
  • API documentation updates.
  • Editor translation updates.
  • And many more bug fixes and usability enhancements all around the engine!

See the full changelog on GitHub for details.

Downloads

The download links for dev snapshots are not featured on the Download page to avoid confusion for new users. Instead, browse our download repository and fetch the editor binary that matches your platform:

  • Classical build (GDScript, GDNative, VisualScript).
  • Mono build (C# support + all the above). You need to have MSBuild (and on Windows .NET Framework 4.7) installed to use the Mono build. Relevant parts of Mono 6.6.0.166 are included in this build.

Bug reports

As a tester, you are encouraged to open bug reports if you experience issues with 3.2.2 beta 1. Please check first the existing issues on GitHub, using the search function with relevant keywords, to ensure that the bug you experience is not known already.

In particular, any change that would cause a regression in your projects is very important to report (e.g. if something that worked fine in 3.2.1 no longer works in 3.2.2 beta 1).