Upgrading from Godot 4.3 to Godot 4.4

For most games and apps made with 4.3 it should be relatively safe to migrate to 4.4. This page intends to cover everything you need to pay attention to when migrating your project.

Cambios importantes

If you are migrating from 4.3 to 4.4, the breaking changes listed here might affect you. Changes are grouped by areas/systems.

Este artículo indica si cada cambio significativo afecta a GDScript y si el cambio significativo en C# es compatible binario o compatible con el código fuente:

Binary compatible - Existing binaries will load and execute successfully without recompilation, and the run-time behavior won't change.
Compatible con el código fuente: el código fuente se compila correctamente sin ningún cambio al actualizar Godot.

Núcleo

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
FileAccess
Method `open_encrypted` adds a new `iv` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-98918
Method `store_8` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_16` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_32` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_64` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_buffer` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_csv_line` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_double` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_float` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_half` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_line` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_pascal_string` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_real` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_string` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
Method `store_var` changes return type from `void` to `bool`	✔️	❌	✔️	GH-78289
OS
Method `execute_with_pipe` adds a new `blocking` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-94434
Method `read_string_from_stdin` adds a new `buffer_size` parameter [1]	❌	\|✔️ compatible\|	\|✔️ compatible\|	GH-91201
RegEx
Method `compile` adds a new `show_error` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-95212
Method `create_from_string` adds a new `show_error` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-95212
Semaphore
Method `post` adds a new `count` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-93605
TranslationServer
Method `standardize_locale` adds a new `add_defaults` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-98972

Nodos GUI

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
RichTextLabel
Method `push_meta` adds a new `tooltip` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-99481
Method `set_table_column_expand` adds a new `shrink` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-101482
GraphEdit
Method `connect_node` adds a new `keep_alive` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-97449
Signal `frame_rect_changed` changes `new_rect` parameter type from `Vector2` to `Rect2`	❌	❌	❌	GH-102796

Física

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
SoftBody3D
Method `set_point_pinned` adds a new `insert_at` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-94684

Renderizado

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
CPUParticles2D
Method `restart` adds a new `keep_seed` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-92089
CPUParticles3D
Method `restart` adds a new `keep_seed` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-92089
GPUParticles2D
Method `restart` adds a new `keep_seed` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-92089
GPUParticles3D
Method `restart` adds a new `keep_seed` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-92089
RenderingDevice
Method `draw_list_begin` adds a new `breadcrumb` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-90993
Method `draw_list_begin` removes many parameters	❌	\|✔️ compatible\|	\|✔️ compatible\|	GH-98670
Method `index_buffer_create` adds a new `enable_device_address` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-100062
Method `uniform_buffer_create` adds a new `enable_device_address` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-100062
Method `vertex_buffer_create` adds a new `enable_device_address` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-100062
RenderingServer
Method `multimesh_allocate_data` adds a new `use_indirect` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-99455
Shader
Method `get_default_texture_parameter` changes return type from `Texture2D` to `Texture`	✔️	❌	❌	GH-95126
Method `set_default_texture_parameter` changes `texture` parameter type from `Texture2D` to `Texture`	✔️	❌	✔️	GH-95126
VisualShaderNodeCubemap
Property `cube_map` changes type from `Cubemap` to `TextureLayered`	✔️	❌	❌	GH-95126
VisualShaderNodeTexture2DArray
Property `texture_array` changes type from `Texture2DArray` to `TextureLayered`	✔️	❌	❌	GH-95126

Nota

In C#, the enum RenderingDevice.StorageBufferUsage breaks compatibility because of the way the bindings generator detects the enum prefix. New members where added in GH-100062 to the enum that caused the enum members to be renamed.

Navegación

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
NavigationServer2D
Method `query_path` adds a new `callback` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-100129
NavigationServer3D
Method `query_path` adds a new `callback` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-100129

Plugins del editor

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
EditorInterface
Method `open_scene_from_path` adds a new `set_inherited` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-90057
Method `popup_node_selector` adds a new `current_value` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-94323
Method `popup_property_selector` adds a new `current_value` optional parameter	✔️	\|✔️ compatible\|	\|✔️ compatible\|	GH-94323
EditorSceneFormatImporter
Method `_get_import_flags` removed	❌	❌	❌	GH-101531
EditorTranslationParserPlugin
Method `_parse_file` changes return type to `Array` and removes `msgids` and `msgids_context_plural` parameters	❌	❌	❌	GH-99297

Nota

The method _get_import_flags was never used by the engine. It was removed despite the compatibility breakage as there's no way for users to rely on this affecting engine behavior.

Cambios de comportamiento

Núcleo

Nota

The Curve resource now enforces its value range, so min_value and max_value need to be changed if any of the points fall outside of the default [0, 1] range.

Renderizado

Nota

The VisualShaderNodeVec4Constant shader node had its input type changed to Vector4. Users need to recreate the values in their constants.

CSG

Nota

The CSG implementation now uses Emmett Lalish's Manifold library (GH-94321). The new implementation is more consistent with manifold definitions and fixes a number of bugs and stability issues. As a result, non-manifold meshes are no longer supported. You can use MeshInstance3D for rendering non-manifold geometry, such as quads or planes.

Android

Nota

Android sensor events are no longer enabled by default (GH-94799). Projects that use sensor events can enable them as needed in Project Settings under Input Devices > Sensors.