From 7d28b535d5b035b131f3fcd73e3c13327c0c0239 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Wed, 17 Sep 2025 18:51:12 +0200 Subject: [PATCH] Mention new warnings for `ProjectSettings.add_property_info()` in Upgrading to Godot 4.5 The behavior is the same as before, but it now prints a warning whereas it previously ignored the `usage` key silently. --- tutorials/migrating/upgrading_to_godot_4.5.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/tutorials/migrating/upgrading_to_godot_4.5.rst b/tutorials/migrating/upgrading_to_godot_4.5.rst index 871d6e6467b..7f43cbbcc2e 100644 --- a/tutorials/migrating/upgrading_to_godot_4.5.rst +++ b/tutorials/migrating/upgrading_to_godot_4.5.rst @@ -204,6 +204,17 @@ new behavior, you must change the "Naming Version" option at the bottom of the I Core ~~~~ +.. note:: + + :ref:`ProjectSettings.add_property_info() ` + now prints a warning when the dictionary parameter has missing keys or invalid keys. + Most importantly, it will now warn when a ``usage`` key is passed, as this key is not used. + This was also the case before 4.5, but it was silently ignored instead. + As a reminder, to set property usage information correctly, you must use + :ref:`ProjectSettings.set_as_basic() `, + :ref:`ProjectSettings.set_restart_if_changed() `, + or :ref:`ProjectSettings.set_as_internal() ` instead. + .. note:: In C#, ``StringExtensions.PathJoin`` now avoids adding an extra path separator when the original string is empty,