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

Atualizando do Godot 4.5 para o Godot 4.6

Para a maioria dos jogos e aplicativos feitos com a versão 4.5, deve ser relativamente seguro migrar para a 4.6. Esta página tem como objetivo cobrir tudo o que você precisa observar ao migrar seu projeto.

Alterações incompatíveis

Se você estiver migrando da 4.5 para a 4.6, as mudanças incompatíveis listadas aqui podem afetá-lo. As alterações estão agrupadas por áreas/sistemas.

Este artigo indica se cada alteração drástica afeta o GDScript e se a alteração drástica do C# é compatível com o binário ou compatível com o código-fonte:

• Compatível em nível binário - Binários existentes serão carregados e executados com sucesso sem recompilação, e o comportamento em tempo de execução não será alterado.

• Compatível com a fonte - O código fonte será compilado com sucesso, sem alterações, ao atualizar o Godot.

Componentes Principais

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
FileAccess
Método create_temp altera o tipo do parâmetro mode_flags de int para FileAccess.ModeFlags	✔️	✔️	✔️	GH-114053
Método get_as_text remove o parâmetro skip_cr	✔️	✔️	✔️	GH-110867
Desempenho
Método add_custom_monitor adiciona um novo parâmetro opcional type	✔️	✔️	✔️	GH-110433

Animação

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
AnimationPlayer
Propriedade assigned_animation altera o tipo de String para StringName	✔️	❌	❌	GH-110767
Propriedade autoplay altera o tipo de String para StringName	✔️	❌	❌	GH-110767
Propriedade current_animation altera o tipo de String para StringName	✔️	❌	❌	GH-110767
Método get_queue altera o tipo de retorno de PackedStringArray para StringName[]	✔️	❌	❌	GH-110767
Sinal current_animation_changed altera o tipo do parâmetro name de String para StringName	✔️	❌	❌	GH-110767

3D

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
SpringBoneSimulator3D
Método get_end_bone_direction altera o tipo de retorno de SpringBoneSimulator3D.BoneDirection para SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Método get_joint_rotation_axis altera o tipo de retorno de SpringBoneSimulator3D.RotationAxis para SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Método get_rotation_axis altera o tipo de retorno de SpringBoneSimulator3D.RotationAxis para SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Método set_end_bone_direction altera o tipo do parâmetro bone_direction de SpringBoneSimulator3D.BoneDirection para SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Método set_joint_rotation_axis altera o tipo do parâmetro axis de SpringBoneSimulator3D.RotationAxis para SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Método set_rotation_axis altera o tipo do parâmetro axis de SpringBoneSimulator3D.RotationAxis para SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120

Renderização

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
DisplayServer
Método accessibility_create_sub_text_edit_elements adiciona um novo parâmetro opcional is_last_line	✔️	✔️	✔️	GH-113459
Método tts_speak altera os metadados do tipo do parâmetro utterance_id de int32 para int64	✔️	✔️	✔️	GH-112379

Nós de GUI

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
Control
Método grab_focus adiciona um novo parâmetro opcional hide_focus	✔️	✔️	✔️	GH-110250
Método has_focus adiciona um novo parâmetro opcional ignore_hidden_focus	✔️	✔️	✔️	GH-110250
FileDialog
Método add_filter adiciona um novo parâmetro opcional mime_type	✔️	✔️	✔️	GH-111439
LineEdit
Método edit adiciona um novo parâmetro opcional hide_focus	✔️	✔️	✔️	GH-111117
SplitContainer
Método clamp_split_offset adiciona um novo parâmetro opcional priority_index	✔️	✔️	✔️	GH-90411

Redes

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
StreamPeerTCP
Método disconnect_from_host movido para a classe base StreamPeerSocket	✔️	✔️	✔️	GH-107954
Método get_status movido para a classe base StreamPeerSocket	✔️	❌	✔️	GH-107954
Método poll movido para a classe base StreamPeerSocket	✔️	✔️	✔️	GH-107954
TCPServer
Método is_connection_available movido para a classe base SocketServer	✔️	✔️	✔️	GH-107954
Método is_listening movido para a classe base SocketServer	✔️	✔️	✔️	GH-107954
Método stop movido para a classe base SocketServer	✔️	✔️	✔️	GH-107954

OpenXR

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
OpenXRExtensionWrapper
Método _get_requested_extensions adiciona um novo parâmetro xr_version	❌	❌	❌	GH-109302
Método _set_instance_create_info_and_get_next_pointer adiciona um novo parâmetro xr_version	N/D	N/D	N/D	GH-109302

Nota

O tipo OpenXRExtensionWrapper destina-se a ser subclassificado de GDExtensions. O método _set_instance_create_info_and_get_next_pointer tem um parâmetro void* para que não esteja exposto ao scripting.

Editor

Mudança	Compatível com GDScript	Compatível com C# Binário	Compatível com fonte C#	Introduzido
EditorExportPreset
Método get_script_export_mode altera o tipo de retorno de int para EditorExportPreset.ScriptExportMode	✔️	❌	❌	GH-107167
EditorFileDialog
Método add_filter movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método add_option movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método add_side_menu removido	❌	❌	❌	GH-111162
Método clear_filename_filter movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método clear_filters movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_filename_filter movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_line_edit movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_option_default movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_option_name movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_option_values movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_selected_options movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método get_vbox movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método invalidate movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método popup_file_dialog movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método set_filename_filter movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método set_option_default movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método set_option_name movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Método set_option_values movido para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade access movida para a classe base FileDialog	✔️	❌	✔️	GH-111212
Propriedade current_dir movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade current_file movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade current_path movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade display_mode movida para a classe base FileDialog	✔️	❌	✔️	GH-111212
Propriedade file_mode movida para a classe base FileDialog	✔️	❌	✔️	GH-111212
Propriedade filters movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade option_count movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Propriedade show_hidden_files movida para a classe base FileDialog	✔️	✔️	✔️	GH-111212
Sinal dir_selected movido para a classe base FileDialog	✔️	❌	✔️	GH-111212
Sinal filename_filter_changed movido para a classe base FileDialog	✔️	❌	✔️	GH-111212
Sinal file_selected movido para a classe base FileDialog	✔️	❌	✔️	GH-111212
Sinal files_selected movido para a classe base FileDialog	✔️	❌	✔️	GH-111212

Mudanças de comportamento

Android

Nota

A configuração de conjuntos de origem para modelos de exportação Android foi atualizada para corresponder à estrutura padrão do projeto Android Studio (GH-110829). Isso afeta o layout do diretório do projeto Android:

• Arquivos anteriormente em [Project root]/android/build/src/ estão agora em [Project root]/android/build/src/main/java/.

• O diretório de arquivos e ativos do Android foi movido para subdiretórios src/main/.

Por exemplo, GodotApp.java movido de src/com/godot/game/GodotApp.java para src/main/java/com/godot/game/GodotApp.java.

Componentes Principais

Nota

O Formato de arquivo TSCN foi alterado de duas maneiras na Godot 4.6:

• O atributo load_steps não é mais gravado nos arquivos de cena (GH-103352). Esse atributo não era utilizado pelo editor.

• Agora, os IDs de nós exclusivos são salvos nos arquivos de cena para ajudar a rastrear os nós quando eles são movidos ou renomeados (GH-106837). Isso torna a refatoração de cenas significativamente mais robusta.

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 (regardless of other incompatible changes performed in the scene itself).

Consequentemente, ao salvar uma cena que foi editada pela última vez no Godot 4.5 no Godot 4.6, ocorrerão diferenças significativas nos programas de versionamento. Essas diferenças são esperadas.

Como lembrete, você pode atualizar todos os arquivos de um projeto para o formato mais recente usando Project > Tools > Upgrade Project Files... no editor e, em seguida, confirmar as alterações no versionamento. Isso permite evitar grandes diferenças posteriormente ao editar cenas.

Renderização

Nota

O modo de mesclagem padrão para Glow agora é Screen, que parece mais correto, mas é significativamente mais brilhante do que o modo Soft Light anterior (GH-110671).

Diversas outras configurações padrão de brilho foram alteradas para garantir que o brilho não ficasse muito forte, mas provavelmente você precisará ajustar as propriedades de brilho nas configurações de Environment após a atualização.

Além disso, o modo de mesclagem Soft Light (Luz Suave) do glow agora sempre se comporta como fazia anteriormente com use_hdr_2d, independentemente da configuração use_hdr_2d da Viewport (GH-109971).

Ao usar o renderizador Mobile, o efeito de brilho reescrito terá uma aparência significativamente diferente da anterior por motivos de desempenho (GH-110077). Talvez seja necessário ajustar ainda mais as configurações de brilho no Environment para obter uma aparência semelhante à anterior.

Nota

A mesclagem de névoa volumétrica foi alterada para ser mais fisicamente precisa (GH-112494). Isso fará com que a névoa volumétrica pareça mais brilhante na maioria das cenas.

Para compensar isso, você precisará diminuir a densidade ou o brilho da névoa volumétrica no Environment, ou diminuir a propriedade Energia da Névoa Volumétrica em luzes específicas.

Navegação

Nota

AStar2D.get_point_path, AStar3D.get_point_path, AStarGrid2D.get_id_path e AStarGrid2D.get_point_path agora retornarão um caminho vazio quando from_id for um ponto desabilitado/sólido (GH-113988).

Valores padrão alterados

Os seguintes valores padrão foram alterados. Se o seu projeto depende dos padrões anteriores, você pode precisar definir explicitamente os valores antigos.

Nota

O driver de renderização padrão no Windows para projetos recentemente criados é agora D3D12 (GH-113213). Isso pode ser alterado nas configurações do projeto abaixo de rendering/rendering_device/driver.windows.

Nota

O motor de física 3D padrão para projetos recentemente criados* é agora Jolt Physics (GH-105737). Isso pode ser alterado nas Configurações do Projeto em physics/3d/physics_engine.

3D

Membro	Valor Antigo	Novo Valor	Introduzido
Malha de Instância 3D
Propriedade skeleton	NodePath("..")	NodePath("")	GH-112267

Nota

O valor padrão de skeleton mudou. Habilite animation/compatibility/default_parent_skeleton_in_mesh_instance_3d nas Configurações do Projeto se o velho comportamento for necessário para compatibilidade.

Renderização

Membro	Valor Antigo	Novo Valor	Introduzido
ProjectSettings
Propriedade rendering/reflections/sky_reflections/roughness_layers	8	7	GH-107902
Propriedade rendering/rendering_device/d3d12/agility_sdk_version	613	618	GH-114043
Environment
Propriedade glow_blend_mode	2	1	GH-110671
Propriedade glow_intensity	0.8	0.3	GH-110671
Propriedade glow_levels/2	0.0	0.8	GH-110671
Propriedade glow_levels/3	1.0	0.4	GH-110671
Propriedade glow_levels/4	0.0	0.1	GH-110671
Propriedade glow_levels/5	1.0	0.0	GH-110671
Propriedade ssr_depth_tolerance	0.2	0.5	GH-111210

Nós de GUI

Propriedade/Parâmetro	Valor Antigo	Novo Valor	Introduzido
PopupMenu
Propriedade submenu_popup_delay	0.3	0.2	GH-110256
ResourceImporterCSVTranslation
Propriedade compress	true	1	GH-112073