Godot 3.6.1 is a maintenance release for the editor version that was launched in September of the previous year. The update addresses several significant issues, including a regression in grid snapping and ruler functionality when zoomed in, as well as a performance regression related to directional shadow fade_start. The primary updates since version 3.6-stable encompass enhancing the visibility of selected tiles with a red outline, rectifying the client interpolation pump, and optimizing cache management. Additional modifications consist of renaming PKEY_Device_FriendlyName, correcting invalid output operators, relocating MonoGCHandle into the gdmono namespace, preventing debug lock from accessing dangling pointers, rectifying the parsing of 4 in Expression, caching results for TranslationServer.compare_locales(), and addressing errors that occur when non-ASCII characters are present in the resource pack path. The update encompasses enhancements in documentation, including timer autostart in tool scripts and radial_center_offset bounds for TextureProgress. The update encompasses enhancements for Xbox Controller compatibility on Android, addresses physics platform behavior regressions, improves porting processes, and refines physics interpolation. The update encompasses enhancements to third-party libraries, including mbedtls and mbedTLS, as well as resolutions for double free issues in mkvparser ContentEncoding.

Maintenance release: Godot 3.6.1

Godot 3.6 was released in September last year, and it has been mostly stable, although there have been a few more important bugs which warrant a maintenance “patch” release (3.6.x).

As well as bug fixes, this release also contains some cherry-picks from 4.x to update libraries. Let us know if you spot any regressions.

Jump to the Downloads section.

As usual, you can try it live with the  online version of the Godot editor updated for this release.

---

Major bugs fixed Grid snapping + ruler in editor

A small change to Range::set_value unfortunately led to a major regression in grid and ruler behaviour when zoomed in ( GH-98466).

We decided on balance the safest course of action in 3.x was to revert the change.

• GUI: Revert changes to Range::set_value ( GH-100459).

Performance regression due to directional shadow fade_start

Users noticed a drop in performance in 3D scenes with DirectionalLight in Godot 3.6 compared to 3.5. We tracked this down to the introduction of the fade_start property, which made some changes to the shader.

We were able to fix this up with some modifications.

• Rendering: Ameliorate performance regression due to directional shadow fade_start ( GH-99536).

Changes

Here are the main changes since 3.6-stable:

2D

• Make selected tile in TileSet more visible through red outline ( GH-105439).

3D

• Physics Interpolation - fix client interpolation pump ( GH-102184).

Audio

• Initialize pa_buffer_attr.maxlength to -1 ( GH-102069).
• ResourceImporterWAV: Detect if data chunk size is larger than the actual size ( GH-107694).

Buildsystem

• Fix VS project generation with SCons 4.8.0+ ( GH-94117).
• CI: Update Linux runners to Ubuntu 24.04, but keep 22.04 for Linux builds ( GH-98896).
• Improve cache handling ( GH-98992).
• Windows: Rename PKEY_Device_FriendlyName to avoid duplicate symbols with newer MinGW SDKs ( GH-99036).
• embree: Fix invalid output operators raising errors with GCC 15 ( GH-102023).

C#

• Mono: Move MonoGCHandle into gdmono namespace ( GH-106578).

Core

• Object::call() prevent debug lock accessing dangling pointer ( GH-96862).
• Fix parsing of 4. in Expression ( GH-96891).
• Cache results for TranslationServer.compare_locales() ( GH-98234).
• Fix error when non-ASCII characters in resource pack path ( GH-98843).
• JavaScript: Don’t cache emsdk ( GH-99037).
• Prevent inlining error printing functions ( GH-103621).

Documentation

• Document Timer autostart in tool scripts ( GH-99048).
• Document radial_center_offset bounds for TextureProgress ( GH-99869).
• Docs: Add description for BitMap.opaque_to_polygons method ( GH-102684).

Editor

• Cancel tooltips when the mouse leaves the window ( GH-95978).

GDScript

• Backport “Cleanup function state connections when destroying instance” for Godot 3 ( GH-97464).

GUI

• Fix button click detection when Tree is rotated ( GH-98300).
• Fix PopupMenu margin and separation calculations ( GH-98452).
• Fix Button not listing hover_pressed stylebox ( GH-98511).
• Improve TextureProgress.set_radial_initial_angle() by removing loops ( GH-99434).
• Show TextureProgress radial center cross only when editing the scene ( GH-99870).
• Revert changes to Range::set_value #65101 ( GH-100459).
• [3.x, RTL] Track external changes in the custom fonts set by BBCode / push_font ( GH-105266).
• Revert “Fix Button not listing hover_pressed stylebox” ( GH-107696).

Input

• Fix Xbox Controller on Android ( GH-106021).

Physics

• Fix physics platform behaviour regression ( GH-97316).

Porting

• Disable Nahimic code injection ( GH-99388).

Rendering

• Ameliorate performance regression due to directional shadow fade_start ( GH-99536).
• Hide last DirectionalLight shadow split distance property when using PSSM 3 Splits ( GH-99554).
• Physics Interpolation - Add editor warning for non-interpolated PhysicsBody ( GH-103355).

Thirdparty

• certs: Sync with Mozilla bundle as of Oct 19, 2024 ( GH-98855).
• Update the Thirdparty section of CHANGELOG.md ( GH-99692).
• mbedtls: Update to upstream version 2.28.9 ( GH-100013).
• mbedTLS: Update to version 2.28.10 ( GH-104580).
• certs: Sync with upstream as of Apr 8 2025 ( GH-106615).
• Fix unzSeekCurrentFile not resetting total_out_64 ( GH-106872).
• libwebm: Fix double free in mkvparser ContentEncoding ( GH-107781).

Changelog

21 contributors submitted around 45 fixes for this release. See our  interactive changelog for the complete list of changes since the 3.6 release.

This release is built from commit  b1ba98fce.

Maintenance release: Godot 3.6.1