godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2025-12-31 17:49:03 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #11311 from smix8/upgrade4.5

Browse Source 
Add 4.5 upgrade Navigation notes
This commit is contained in:
Max Hilbrunner
2025-09-22 16:59:28 +02:00
committed by GitHub
parent e8e6a57c2b 9d281b035b
commit 4ff1c17ece
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
tutorials/migrating/upgrading_to_godot_4.5.rst
View File

@@ -231,6 +231,25 @@ Core
the shortest arc between the two input vectors. Previously, it would return incorrect values for certain inputs
(`GH-107618`_).
Navigation
~~~~~~~~~~
.. note::
By default, the regions in a NavigationServer map now update asynchronously using threads to improve performance.
This can cause additional delay in the update due to thread synchronisation.
The asynchronous region update can be toggled with the ``navigation/world/region_use_async_iterations`` project setting.
.. note::
The merging of navmeshes in the NavigationServer has changed processing order. Regions now merge and cache
internal navmeshes first, then the remaining free edges are merged by the navigation map.
If a project had navigation map synchronisation errors before, it might now have shifted
affected edges, making already existing errors in a layout more noticeable in the pathfinding.
The ``navigation/2d_or_3d/merge_rasterizer_cell_scale`` project setting can be set to a lower value
to increase the detail of the rasterization grid (with `0.01` being the smallest cell size possible).
If edge merge errors still persist with the lowest possible rasterization scale value,
the error may be caused by overlap: two navmeshes are stacked on top of each other, causing geometry conflict.
Physics
~~~~~~~