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

Оновлення з Godot 4.5 до Godot 4.6

Для більшості ігор та програм, створених з версії 4.5, перехід на версію 4.6 має бути відносно безпечним. На цій сторінці викладено все, на що потрібно звернути увагу під час перенесення вашого проєкту.

Ломальні зміни

Якщо ви переходите з версії 4.5 на 4.6, перелічені тут критичні зміни можуть вплинути на вас. Зміни згруповано за областями/системами.

У цій статті вказується, чи кожна порушна зміна впливає на GDScript і чи є порушна зміна C# бінарною сумісністю чи сумісною з джерелом:

• Сумісність з бінарними файлами – Існуючі бінарні файли успішно завантажаться та виконаються без перекомпіляції, а поведінка під час виконання не зміниться.

• Сумісність із вихідним кодом – вихідний код буде успішно скомпільовано без змін під час оновлення Godot.

Ядро

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
FileAccess
Метод create_temp змінює тип параметра mode_flags з int на FileAccess.ModeFlags	✔️	✔️	✔️	GH-114053
Метод get_as_text вилучає параметр skip_cr	✔️	✔️	✔️	GH-110867
Продуктивність
Метод add_custom_monitor додає новий необов'язковий параметр type	✔️	✔️	✔️	GH-110433

Анімація

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
Програвач анімації
Властивість assigned_animation змінює тип з String на StringName	✔️	❌	❌	GH-110767
Властивість autoplay змінює тип з String на StringName	✔️	❌	❌	GH-110767
Властивість current_animation змінює тип з String на StringName	✔️	❌	❌	GH-110767
Метод get_queue змінює тип повернення з PackedStringArray на StringName[]	✔️	❌	❌	GH-110767
Сигнал current_animation_changed змінює тип параметра name з String на StringName	✔️	❌	❌	GH-110767

Просторова графіка

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
SpringBoneSimulator3D
Метод get_end_bone_direction змінює тип повернення з SpringBoneSimulator3D.BoneDirection на SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Метод get_joint_rotation_axis змінює тип повернення з SpringBoneSimulator3D.RotationAxis на SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Метод get_rotation_axis змінює тип повернення з SpringBoneSimulator3D.RotationAxis на SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Метод set_end_bone_direction змінює тип параметра bone_direction з SpringBoneSimulator3D.BoneDirection на SkeletonModifier3D.BoneDirection	✔️	❌	✔️	GH-110120
Метод set_joint_rotation_axis змінює тип параметра axis з SpringBoneSimulator3D.RotationAxis на SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120
Метод set_rotation_axis змінює тип параметра axis з SpringBoneSimulator3D.RotationAxis на SkeletonModifier3D.RotationAxis	✔️	❌	✔️	GH-110120

Рендеринг

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
DisplayServer
Метод accessibility_create_sub_text_edit_elements додає новий необов'язковий параметр is_last_line	✔️	✔️	✔️	GH-113459
Метод tts_speak змінює метадані типу параметра utterance_id з int32 на int64	✔️	✔️	✔️	GH-112379

Вузли GUI

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
Control
Метод grab_focus додає новий необов'язковий параметр hide_focus	✔️	✔️	✔️	GH-110250
Метод has_focus додає новий необов'язковий параметр ignore_hidden_focus	✔️	✔️	✔️	GH-110250
FileDialog
Метод add_filter додає новий необов'язковий параметр mime_type	✔️	✔️	✔️	GH-111439
LineEdit
Метод edit додає новий необов'язковий параметр hide_focus	✔️	✔️	✔️	GH-111117
SplitContainer
Метод clamp_split_offset додає новий необов'язковий параметр priority_index	✔️	✔️	✔️	GH-90411

Робота у мережі

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
StreamPeerTCP
Метод disconnect_from_host переміщено до базового класу StreamPeerSocket	✔️	✔️	✔️	GH-107954
Метод get_status переміщено до базового класу StreamPeerSocket	✔️	❌	✔️	GH-107954
Метод poll переміщено до базового класу StreamPeerSocket	✔️	✔️	✔️	GH-107954
TCPServer
Метод is_connection_available переміщено до базового класу SocketServer	✔️	✔️	✔️	GH-107954
Метод is_listening переміщено до базового класу SocketServer	✔️	✔️	✔️	GH-107954
Метод stop перенесено до базового класу SocketServer	✔️	✔️	✔️	GH-107954

openXR

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
OpenXRExtensionWrapper
Метод _get_requested_extensions додає новий параметр xr_version	❌	❌	❌	GH-109302
Метод _set_instance_create_info_and_get_next_pointer додає новий параметр xr_version	N/A	N/A	N/A	GH-109302

Примітка

Тип OpenXRExtensionWrapper призначений для створення підкласу з GDExtensions. Метод _set_instance_create_info_and_get_next_pointer має параметр void*, тому він не піддається сценаріям.

Редактор

Зміна	Сумісність з GDScript	C# двійковий сумісний	Сумісність із вихідним кодом C#	Введено
EditorExportPreset
Метод get_script_export_mode змінює тип повернення з int на EditorExportPreset.ScriptExportMode	✔️	❌	❌	GH-107167
EditorFileDialog
Метод add_filter переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод add_option переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод add_side_menu вилучено	❌	❌	❌	GH-111162
Метод clear_filename_filter переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод clear_filters переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_filename_filter переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_line_edit переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_option_default переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_option_name переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_option_values переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_selected_options переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод get_vbox переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод invalidate переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод popup_file_dialog переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод set_filename_filter переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод set_option_default переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод set_option_name переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Метод set_option_values переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість access переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Властивість current_dir переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість current_file переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість current_path переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість display_mode переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Властивість file_mode переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Властивість filters переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість option_count переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Властивість show_hidden_files переміщено до базового класу FileDialog	✔️	✔️	✔️	GH-111212
Сигнал dir_selected переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Сигнал filename_filter_changed переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Сигнал file_selected переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212
Сигнал files_selected переміщено до базового класу FileDialog	✔️	❌	✔️	GH-111212

Зміни поведінки

Android

Примітка

Конфігурацію вихідних наборів для шаблонів експорту Android оновлено відповідно до стандартної структури проекту Android Studio (GH-110829). Це впливає на розташування каталогів проекту Android:

• Файли, які раніше знаходилися в [Project root]/android/build/src/, тепер знаходяться в [Project root]/android/build/src/main/java/.

• Файл маніфесту Android та каталог ресурсів переміщено до підкаталогів src/main/.

Наприклад, файл GodotApp.java переміщено з src/com/godot/game/GodotApp.java до src/main/java/com/godot/game/GodotApp.java.

Ядро

Примітка

У Godot 4.6 формат файлів Формат файлу TSCN зазнав двох змін:

• Атрибут load_steps більше не записується у файли сцен (GH-103352). Цей атрибут не використовувався редактором.

• Тепер унікальні ідентифікатори вузлів зберігаються у файлах сцен, що полегшує відстеження вузлів під час їх переміщення або перейменування (GH-106837). Це значно підвищує надійність рефакторингу сцен.

Ці зміни є сумісними як із попередніми, так і з наступними версіями, тобто сцени, збережені в Godot 4.5, можна завантажувати в Godot 4.6 і навпаки (за винятком інших несумісних змін, внесених у саму сцену).

Як наслідок, під час збереження сцени, яка востаннє редагувалася в Godot 4.5, у Godot 4.6 у програмах контролю версій з’являться значні розбіжності. Ці розбіжності є очікуваними.

Нагадуємо, що ви можете оновити всі файли в проєкті до останньої версії, скориставшись меню :Project > Tools > Upgrade Project Files... у редакторі, а потім зафіксувавши зміни в системі контролю версій. Це дозволить уникнути великих розбіжностей під час подальшого редагування сцен.

Рендеринг

Примітка

Тепер режимом накладання за замовчуванням для ефекту «Світіння» є «Екран», що виглядає більш природно, але є значно яскравішим, ніж попередній режим «М'яке світло» (GH-110671).

Було змінено ще кілька стандартних налаштувань світіння, щоб воно не було надто яскравим, але після оновлення вам, ймовірно, доведеться налаштувати параметри світіння в розділі «Environment».

Крім того, режим накладання «М'яке світло» (Soft Light) у Glow тепер завжди працює так само, як раніше при використанні параметра use_hdr_2d, незалежно від налаштування use_hdr_2d у вікні перегляду (GH-109971).

При використанні мобільного рендерера перероблений ефект світіння буде виглядати значно інакше, ніж попередній, через вимоги до продуктивності (GH-110077). Можливо, вам доведеться додатково налаштувати параметри світіння в розділі «Середовище», щоб досягти вигляду, схожого на попередній.

Примітка

Механізм змішування об'ємного туману було змінено з метою підвищення фізичної точності (GH-112494). Це призведе до того, що об'ємний туман у більшості сцен виглядатиме світлішим.

Щоб це виправити, вам потрібно зменшити щільність або яскравість об’ємного туману в розділі «Environment» або зменшити значення параметра Volumetric Fog Energy для окремих джерел світла.

Навігація

Примітка

AStar2D.get_point_path, AStar3D.get_point_path, AStarGrid2D.get_id_path а AStarGrid2D.get_point_path тепер повертатиме порожній шлях, якщо from_id є вимкненою/суцільною точкою (GH-113988).

Змінені налаштування за замовчуванням

Наведені нижче значення за замовчуванням було змінено. Якщо ваш проект використовує попередні значення за замовчуванням, можливо, вам доведеться явно встановити для них старі значення.

Примітка

Драйвер рендерингу за замовчуванням у Windows для щойно створених проектів тепер D3D12 (GH-113213). Це можна змінити в налаштуваннях проекту в розділі rendering/rendering_device/driver.windows.

Примітка

Стандартним 3D-фізичним рушієм для щойно створених проєктів тепер є Jolt Physics (GH-105737). Це можна змінити в налаштуваннях проєкту в розділі physics/3d/physics_engine.

Просторова графіка

Член	Старе значення	Нова цінність	Введено
MeshInstance3D
Властивість skeleton	NodePath("..")	NodePath("")	GH-112267

Примітка

Значення за замовчуванням skeleton змінилося. Увімкніть animation/compatibility/default_parent_skeleton_in_mesh_instance_3d у налаштуваннях проекту, якщо для сумісності потрібна стара поведінка.

Рендеринг

Член	Старе значення	Нова цінність	Введено
ProjectSettings
Властивість rendering/reflections/sky_reflections/roughness_layers	8	7	GH-107902
Властивість rendering/rendering_device/d3d12/agility_sdk_version	613	618	GH-114043
Навколишнє середовище
Властивість glow_blend_mode	2	1	GH-110671
Властивість glow_intensity	0.8	0.3	GH-110671
Властивість glow_levels/2	0.0	0.8	GH-110671
Властивість glow_levels/3	1.0	0.4	GH-110671
Властивість glow_levels/4	0.0	0.1	GH-110671
Властивість glow_levels/5	1.0	0.0	GH-110671
Властивість ssr_depth_tolerance	0.2	0.5	GH-111210

Вузли GUI

Властивість/Параметр	Старе значення	Нова цінність	Введено
Спливаюче меню
Властивість submenu_popup_delay	0.3	0.2	GH-110256
ResourceImporterCSVTranslation
Властивість compress	true	1	GH-112073