Merge pull request #11301 from Calinou/upgrading-to-godot-4.5-projectsettings-usage

Mention new warnings for `ProjectSettings.add_property_info()` in Upgrading to Godot 4.5
This commit is contained in:
Max Hilbrunner
2025-09-18 15:26:20 +02:00
committed by GitHub

View File

@@ -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() <class_ProjectSettings_method_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() <class_ProjectSettings_method_set_as_basic>`,
:ref:`ProjectSettings.set_restart_if_changed() <class_ProjectSettings_method_set_restart_if_changed>`,
or :ref:`ProjectSettings.set_as_internal() <class_ProjectSettings_method_set_as_internal>` instead.
.. note::
In C#, ``StringExtensions.PathJoin`` now avoids adding an extra path separator when the original string is empty,