Skip to content

Commit d74dc49

Browse files
Upgrade to 4.3: Add note about Multiplayer protocol compat breakage (#9685)
* Upgrade to 4.3: Add note about Multiplayer protocol compat breakage Closes godotengine/godot#94769. --------- Co-authored-by: Max Hilbrunner <[email protected]>
1 parent 95eb1ba commit d74dc49

File tree

1 file changed

+15
-2
lines changed

1 file changed

+15
-2
lines changed

tutorials/migrating/upgrading_to_godot_4.3.rst

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@ Core
237237
.. note::
238238

239239
``PackedByteArray`` is now able to use a more compact base64 encoding for storage. But the trade-off is that it breaks
240-
compatibility, meaning that older versions of Godot may not be able to open resources saved by 4.3. (`GH-89186`_).
240+
compatibility, meaning that older versions of Godot may not be able to open resources saved by 4.3 (`GH-89186`_).
241241

242242
To maximize compatibility, this new storage format will only be enabled for resources and scenes that contain large
243243
PackedByteArrays for now. Support for this new format will also be added in patch updates for older versions of Godot.
@@ -281,7 +281,7 @@ GUI nodes
281281

282282
.. note::
283283

284-
The default font outline color was changed from white to black. (`GH-54641`_).
284+
The default font outline color was changed from white to black (`GH-54641`_).
285285

286286
.. note::
287287

@@ -290,6 +290,18 @@ GUI nodes
290290
from their parent. This means, existing nodes with the ``auto_translate`` property set to ``true`` may no longer be translated if they
291291
are children of a node with the ``auto_translate`` property set to ``false``.
292292

293+
Multiplayer
294+
^^^^^^^^^^^
295+
296+
.. note::
297+
298+
The ``SceneMultiplayer`` caching protocol was changed to send the received ID instead of the Node path when sending a node removal confirmation packet (`GH-90027`_).
299+
300+
This is a breaking change for the high-level multiplayer protocol making it incompatible with previous Godot versions.
301+
Upgrade both your server and client versions to Godot 4.3 to handle this change gracefully.
302+
303+
Note that high-level multiplayer facilities are only ever meant to be compatible with server and client using the same Godot version. It is recommended to implement some kind of version checking.
304+
293305
Rendering
294306
^^^^^^^^^
295307

@@ -357,6 +369,7 @@ Android
357369
.. _GH-89843: https://github.com/godotengine/godot/pull/89843
358370
.. _GH-89849: https://github.com/godotengine/godot/pull/89849
359371
.. _GH-89851: https://github.com/godotengine/godot/pull/89851
372+
.. _GH-90027: https://github.com/godotengine/godot/pull/90027
360373
.. _GH-90575: https://github.com/godotengine/godot/pull/90575
361374
.. _GH-90645: https://github.com/godotengine/godot/pull/90645
362375
.. _GH-90732: https://github.com/godotengine/godot/pull/90732

0 commit comments

Comments
 (0)