Browse Source

Document TileMapLayer physics chunking caveats in Upgrading to Godot 4.5

Hugo Locurcio 1 week ago
parent
commit
d8ec75b547
1 changed files with 12 additions and 0 deletions
  1. 12 0
      tutorials/migrating/upgrading_to_godot_4.5.rst

+ 12 - 0
tutorials/migrating/upgrading_to_godot_4.5.rst

@@ -190,6 +190,18 @@ Behavior changes
 
 
 In 4.5 some behavior changes have been introduced, which might require you to adjust your project.
 In 4.5 some behavior changes have been introduced, which might require you to adjust your project.
 
 
+TileMapLayer
+~~~~~~~~~~~~
+
+:ref:`TileMapLayer.get_coords_for_body_rid() <class_TileMapLayer_method_get_coords_for_body_rid>`
+will return different values in 4.5 compared to 4.4,
+as TileMapLayer physics chunking is enabled by default. Higher values of
+:ref:`TileMapLayer.physics_quadrant_size <class_TileMapLayer_property_physics_quadrant_size>`
+will make this function less precise. To get the exact cell coordinates like in 4.4 and prior
+versions, you need to set
+:ref:`TileMapLayer.physics_quadrant_size <class_TileMapLayer_property_physics_quadrant_size>`
+to ``1``, which disables physics chunking.
+
 3D Model Import
 3D Model Import
 ~~~~~~~~~~~~~~~
 ~~~~~~~~~~~~~~~