You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: tutorials/migrating/upgrading_to_godot_4.4.rst
+13-10Lines changed: 13 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -59,21 +59,24 @@ Method ``standardize_locale`` adds a new ``add_defaults`` optional parameter
59
59
60
60
.. warning::
61
61
62
-
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.
62
+
The behavior of ``@export_file`` changed in Godot 4.4. When assigning a new value
63
+
from the Inspector, the path is now stored and returned as a ``uid://`` reference
64
+
instead of the traditional ``res://`` path. This is a **breaking change** and may
65
+
cause issues if you're expecting ``res://``-based paths in scripts or serialized
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.
65
-
66
-
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.
67
-
68
-
Related issues:
69
-
70
-
- PR: `Add @export_file_path to export raw paths (no UID) <https://github.com/godotengine/godot/pull/105414>`_
71
-
- Issue: `@export_file behavior change is breaking <https://github.com/godotengine/godot/issues/11065>`_
72
-
- See also: `ProjectSettings stores UIDs for file paths <https://github.com/godotengine/godot/pull/104818>`_
69
+
For example, exported arrays of files may now contain a mix of ``uid://`` and
70
+
``res://`` paths, especially if they were partially edited in the Inspector.
73
71
72
+
In 4.4, the only way to retain the ``res://`` format is to **manually edit** the
73
+
`.tscn` or `.tres` files in a text editor. Starting in Godot 4.5, a new annotation
74
+
``@export_file_path`` can be used to explicitly retain the old behavior and export
0 commit comments