From bf9f61819e33777741dff080dab698ae6d64bdbf Mon Sep 17 00:00:00 2001 From: Ayush Raj <74952106+Ayush41@users.noreply.github.com> Date: Wed, 2 Jul 2025 18:36:53 +0000 Subject: [PATCH 1/4] Added breaking change note for @export_file behavior in 4.4 --- tutorials/migrating/upgrading_to_godot_4.4.rst | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/tutorials/migrating/upgrading_to_godot_4.4.rst b/tutorials/migrating/upgrading_to_godot_4.4.rst index 1e3f455483c..438b6045021 100644 --- a/tutorials/migrating/upgrading_to_godot_4.4.rst +++ b/tutorials/migrating/upgrading_to_godot_4.4.rst @@ -52,8 +52,24 @@ Method ``create_from_string`` adds a new ``show_error`` optional parameter **Semaphore** Method ``post`` adds a new ``count`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-93605`_ **TranslationServer** -Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_ +Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter + |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_ ======================================================================================================================== =================== ==================== ==================== ============ +**Export annotations** + +.. warning:: + + The behavior of ``@export_file`` changed in Godot 4.4. When assigning a new value from the Inspector, the path is now stored and returned as a ``uid://`` reference instead of the traditional ``res://`` path. This is a **breaking change** and may cause issues if you're expecting ``res://``-based paths in scripts or serialized files. + + For example, exported arrays of files may now contain a mix of ``uid://`` and ``res://`` paths, especially if they were edited partially in the Inspector. + + In 4.4, the only way to retain the ``res://`` format is to **manually edit** the `.tscn` or `.tres` files in a text editor. Starting in Godot 4.5, a new annotation ``@export_file_path`` can be used to explicitly retain the old behavior and export raw ``res://`` paths. + + Related issues: + - PR: `Add @export_file_path to export raw paths (no UID) `_ + - Issue: `@export_file behavior change is breaking `_ + - See also: `ProjectSettings stores UIDs for file paths `_ + .. [#f1] Default buffer size in 4.3 is ``1024``. From 7f8550a4ce8c66fe5658a2f963ec8d05d3d77072 Mon Sep 17 00:00:00 2001 From: Ayush Raj <74952106+Ayush41@users.noreply.github.com> Date: Sat, 5 Jul 2025 16:36:01 +0000 Subject: [PATCH 2/4] fixed tab --- tutorials/migrating/upgrading_to_godot_4.4.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/tutorials/migrating/upgrading_to_godot_4.4.rst b/tutorials/migrating/upgrading_to_godot_4.4.rst index 438b6045021..83ed306b286 100644 --- a/tutorials/migrating/upgrading_to_godot_4.4.rst +++ b/tutorials/migrating/upgrading_to_godot_4.4.rst @@ -52,8 +52,7 @@ Method ``create_from_string`` adds a new ``show_error`` optional parameter **Semaphore** Method ``post`` adds a new ``count`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-93605`_ **TranslationServer** -Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter - |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_ +Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_ ======================================================================================================================== =================== ==================== ==================== ============ **Export annotations** From 4191d25d48b2a48646f236e3be3931a30a710c54 Mon Sep 17 00:00:00 2001 From: Ayush Raj <74952106+Ayush41@users.noreply.github.com> Date: Mon, 7 Jul 2025 22:59:05 +0530 Subject: [PATCH 3/4] Update tutorials/migrating/upgrading_to_godot_4.4.rst Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> --- tutorials/migrating/upgrading_to_godot_4.4.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/migrating/upgrading_to_godot_4.4.rst b/tutorials/migrating/upgrading_to_godot_4.4.rst index 83ed306b286..631b3121a18 100644 --- a/tutorials/migrating/upgrading_to_godot_4.4.rst +++ b/tutorials/migrating/upgrading_to_godot_4.4.rst @@ -54,6 +54,7 @@ Method ``post`` adds a new ``count`` optional parameter **TranslationServer** Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter |✔️| |✔️ with compat| |✔️ with compat| `GH-98972`_ ======================================================================================================================== =================== ==================== ==================== ============ + **Export annotations** .. warning:: From 7ba0a7cf0ed37c87ca26e50328c4bcf782f1968b Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Mon, 7 Jul 2025 20:47:19 +0200 Subject: [PATCH 4/4] Apply suggestions from code review --- tutorials/migrating/upgrading_to_godot_4.4.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/tutorials/migrating/upgrading_to_godot_4.4.rst b/tutorials/migrating/upgrading_to_godot_4.4.rst index 631b3121a18..33314f8fc3e 100644 --- a/tutorials/migrating/upgrading_to_godot_4.4.rst +++ b/tutorials/migrating/upgrading_to_godot_4.4.rst @@ -66,6 +66,7 @@ Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter In 4.4, the only way to retain the ``res://`` format is to **manually edit** the `.tscn` or `.tres` files in a text editor. Starting in Godot 4.5, a new annotation ``@export_file_path`` can be used to explicitly retain the old behavior and export raw ``res://`` paths. Related issues: + - PR: `Add @export_file_path to export raw paths (no UID) `_ - Issue: `@export_file behavior change is breaking `_ - See also: `ProjectSettings stores UIDs for file paths `_