Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Migrar desde Godot 4.5 a Godot 4.6

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

Cambios importantes

If you are migrating from 4.5 to 4.6, 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
Acceso a archivos
Method create_temp changes mode_flags parameter type from int to FileAccess.ModeFlags	✔️	|✔️ compatible|	|✔️ compatible|	GH-114053
Method get_as_text removes skip_cr parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-110867
Rendimiento:
Method add_custom_monitor adds a new type optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-110433

Animación

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
AnimationPlayer
Property assigned_animation changes type from String to StringName	✔️	❌	❌	GH-110767
Property autoplay changes type from String to StringName	✔️	❌	❌	GH-110767
Property current_animation changes type from String to StringName	✔️	❌	❌	GH-110767
Method get_queue changes return type from PackedStringArray to StringName[]	✔️	❌	❌	GH-110767
Signal current_animation_changed changes name parameter type from String to StringName	✔️	❌	❌	GH-110767

3D

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
SpringBoneSimulator3D
Method get_end_bone_direction changes return type from SpringBoneSimulator3D.BoneDirection to SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Method get_joint_rotation_axis changes return type from SpringBoneSimulator3D.RotationAxis to SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Method get_rotation_axis changes return type from SpringBoneSimulator3D.RotationAxis to SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Method set_end_bone_direction changes bone_direction parameter type from SpringBoneSimulator3D.BoneDirection to SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Method set_joint_rotation_axis changes axis parameter type from SpringBoneSimulator3D.RotationAxis to SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Method set_rotation_axis changes axis parameter type from SpringBoneSimulator3D.RotationAxis to SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120

Renderizado

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
DisplayServer
Method accessibility_create_sub_text_edit_elements adds a new is_last_line optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-113459
Method tts_speak changes utterance_id parameter type metadata from int32 to int64	✔️	|✔️ compatible|	|✔️ compatible|	GH-112379

Nodos GUI

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
Control
Method grab_focus adds a new hide_focus optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-110250
Method has_focus adds a new ignore_hidden_focus optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-110250
FileDialog
Method add_filter adds a new mime_type optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-111439
LineEdit
Method edit adds a new hide_focus optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-111117
SplitContainer
Method clamp_split_offset adds a new priority_index optional parameter	✔️	|✔️ compatible|	|✔️ compatible|	GH-90411

Redes

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
StreamPeerTCP
Method disconnect_from_host moved to base class StreamPeerSocket	✔️	✔️	✔️	GH-107954
Method get_status moved to base class StreamPeerSocket	✔️	❌	✔️	GH-107954
Method poll moved to base class StreamPeerSocket	✔️	✔️	✔️	GH-107954
TCPServer
Method is_connection_available moved to base class SocketServer	✔️	✔️	✔️	GH-107954
Method is_listening moved to base class SocketServer	✔️	✔️	✔️	GH-107954
Method stop moved to base class SocketServer	✔️	✔️	✔️	GH-107954

OpenXR

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
OpenXRExtensionWrapper
Method _get_requested_extensions adds a new xr_version parameter	❌	❌	❌	GH-109302
Method _set_instance_create_info_and_get_next_pointer adds a new xr_version parameter	N/A	N/A	N/A	GH-109302

Nota

El tipo OpenXRExtensionWrapper está destinado a ser subclasificado desde GDExtensions. El método _set_instance_create_info_and_get_next_pointer tiene un parámetro void*, por lo que no está expuesto al scripting.

Editor

Cambio	Compatibilidad con GDScript	Compatible con binarios C#	Compatible con código fuente C#	Introducido
EditorExportPreset
Method get_script_export_mode changes return type from int to EditorExportPreset.ScriptExportMode	✔️	❌	❌	GH-107167
EditorFileDialog
Method add_filter moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method add_option moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method add_side_menu removed	|❌ con marcador de posición|	|❌ con marcador de posición|	|❌ con marcador de posición|	GH-111162
Method clear_filename_filter moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method clear_filters moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_filename_filter moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_line_edit moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_option_default moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_option_name moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_option_values moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_selected_options moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method get_vbox moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method invalidate moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method popup_file_dialog moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method set_filename_filter moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method set_option_default moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method set_option_name moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Method set_option_values moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property access moved to base class FileDialog	✔️	❌	✔️	GH-111212
Property current_dir moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property current_file moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property current_path moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property display_mode moved to base class FileDialog	✔️	❌	✔️	GH-111212
Property file_mode moved to base class FileDialog	✔️	❌	✔️	GH-111212
Property filters moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property option_count moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Property show_hidden_files moved to base class FileDialog	✔️	✔️	✔️	GH-111212
Signal dir_selected moved to base class FileDialog	✔️	❌	✔️	GH-111212
Signal filename_filter_changed moved to base class FileDialog	✔️	❌	✔️	GH-111212
Signal file_selected moved to base class FileDialog	✔️	❌	✔️	GH-111212
Signal files_selected moved to base class FileDialog	✔️	❌	✔️	GH-111212

Cambios de comportamiento

Android

Nota

Los conjuntos de código fuente que configuran las plantillas de exportación para Android se han actualizado para ajustarse a la estructura de proyecto predeterminada de Android Studio (GH-110829). Esto afecta a la disposición de directorios del proyecto de Android:

• Los archivos que anteriormente se encontraban en [Project root]/android/build/src/ ahora están en [Project root]/android/build/src/main/java/.

• El archivo de manifiesto de Android y el directorio de recursos se han movido a los subdirectorios src/main/.

Por ejemplo, GodotApp.java se movió de src/com/godot/game/GodotApp.java a src/main/java/com/godot/game/GodotApp.java.

Núcleo

Nota

The Formato de archivo TSCN has changed in two ways in Godot 4.6:

• load_steps is no longer written in scene files (GH-103352). This attribute wasn't used by the editor.

• Unique node IDs are now saved to scene files to help track nodes when they are moved or renamed (GH-106837). This makes scene refactoring significantly more robust.

The changes are backwards-compatible and forwards-compatible, which means scenes saved in Godot 4.5 can still be loaded in Godot 4.6 and vice-versa (notwithstanding other incompatible changes performed in the scene itself).

As a result, when saving a scene that was last edited in Godot 4.5 in Godot 4.6, significant diffs will occur in version control programs. These diffs are expected.

As a reminder, you can upgrade all files in a project to the latest format using Project > Tools > Upgrade Project Files... in the editor, then committing the changes to version control. This allows you to avoid large diffs later on when editing scenes.

Renderizado

Nota

The default blend mode for Glow is now Screen, which looks more correct but is significantly brighter than the previous Soft Light mode (GH-110671).

Several other glow defaults were changed to ensure the glow didn't become too strong, but you will likely need to tweak glow properties in Environment after upgrading.

In addition, glow's Soft Light blend mode now always behaves as it did previously with use_hdr_2d, regardless of the Viewport's use_hdr_2d setting (GH-109971).

When using the Mobile renderer, the rewritten glow effect will look significantly different to the previous one for performance reasons (GH-110077). You may need to further adjust glow settings in Environment to achieve a similar look to before.

Nota

Volumetric fog blending has been changed to be more physically accurate (GH-112494). This will cause volumetric fog to appear brighter in most scenes.

To compensate for this, you will need to decrease volumetric fog density or brightness in Environment, or decrease the Volumetric Fog Energy property on specific lights.

Navegación

Nota

AStar2D.get_point_path, AStar3D.get_point_path, AStarGrid2D.get_id_path y AStarGrid2D.get_point_path ahora devolverán una ruta vacía cuando from_id sea un punto deshabilitado/sólido (GH-113988).

Changed defaults

Se han cambiado los siguientes valores predeterminados. Si tu proyecto depende de los valores anteriores, puede que necesites establecerlos explícitamente a los valores antiguos.

Nota

El controlador de renderizado predeterminado en Windows para proyectos recién creados ahora es D3D12 (GH-113213). Esto puede cambiarse en Ajustes del Proyecto, en rendering/rendering_device/driver.windows.

Nota

El motor de física 3D predeterminado para proyectos recién creados ahora es Jolt Physics (GH-105737). Esto puede cambiarse en Ajustes del Proyecto, en physics/3d/physics_engine.

3D

Miembro	Valor antiguo	Nuevo valor	Introducido
MeshInstance3D
Property skeleton	NodePath("..")	NodePath("")	GH-112267

Nota

El valor predeterminado de skeleton ha cambiado. Activa animation/compatibility/default_parent_skeleton_in_mesh_instance_3d en Ajustes del Proyecto si se necesita el comportamiento anterior por compatibilidad.

Renderizado

Miembro	Valor antiguo	Nuevo valor	Introducido
ProjectSettings
Propiedad rendering/reflections/sky_reflections/roughness_layers	8	7	GH-107902
Propiedad rendering/rendering_device/d3d12/agility_sdk_version	613	618	GH-114043
Entorno
Propiedad glow_blend_mode	2	1	GH-110671
Propiedad glow_intensity	0.8	0.3	GH-110671
Propiedad glow_levels/2	0.0	0.8	GH-110671
Propiedad glow_levels/3	1.0	0.4	GH-110671
Propiedad glow_levels/4	0.0	0.1	GH-110671
Propiedad glow_levels/5	1.0	0.0	GH-110671
Propiedad ssr_depth_tolerance	0.2	0.5	GH-111210

Nodos GUI

Propiedad/Parámetro	Valor antiguo	Nuevo valor	Introducido
PopupMenu
Property submenu_popup_delay	0.3	0.2	GH-110256
ResourceImporterCSVTranslation
Property compress	true	1	GH-112073