[Auto] [Improve] Enhanced platformer and top-down movement docs with ladder, drop-through, and isometry details (#455)

Co-authored-by: 4ian <1280130+4ian@users.noreply.github.com>

Author: github-actions[bot]

automated_updates_data.json

@@ -32,6 +32,10 @@
     {
       "date": "2026-02-18",
       "summary": "Improved variables documentation: added array/structure manipulation operations, object variable use-case guidance, and fixed physics2 typos"
+    },
+    {
+      "date": "2026-02-18",
+      "summary": "Improved platformer and top-down movement docs: added ladder climbing, jumpthru drop-through, ledge grab clarifications, and isometric viewpoint options"
     }
   ]
 }

docs/gdevelop5/behaviors/platformer/index.md

@@ -38,6 +38,10 @@ The offset of the grab can also be changed on the Y-axis.
 
 The offset option allows us to change the position of the grab to fit the animation of our character.
 
+!!! note
+
+    A platform must also have **"Grab the ledge"** enabled for a character to grab its edges. Both the platform and the character must have the option enabled.
+
 ### Create platforms with tilemaps
 
 The platform behavior can be added to tilemap collision mask objects. Learn more about it on the [tilemap](/gdevelop5/objects/tilemap#handle_collisions) page.
@@ -85,9 +89,21 @@ Again, as with the "Platform Behavior", we can set the grab offset on the Y axis
 
 By changing the grab tolerance value, we can set how close the character needs to be to the platform in order to allow the character to grab the platform object.
 
+By default, the character can grab a ledge even while standing still. This is useful so that, when moving toward a wall, a character automatically grabs a nearby ledge. You can disable "Automatically grab platform ledges without having to move horizontally" if you only want the character to grab while actively moving.
+
+### Climb a ladder
+
+When the character overlaps a **Ladder** object, pressing the up or down key makes the character climb or descend. Horizontal movement is disabled while on a ladder.
+
+The climbing speed is a separate property from the walking speed and can be adjusted in the behavior properties or changed at runtime with events.
+
+### Go down through a platform
+
+When the character is standing on a **Jumpthru platform**, pressing the down key causes the character to fall through it. This is useful for platforms the player can drop down from, such as floating floors. This behavior is enabled by default and can be turned off in the behavior properties.
+
 ### Slope max angle
 
-By changing this value, we can set the maximum angle of a slope that the player can climb. The default is 0. 0 default means the character can move only on a flat surface.
+By changing this value, we can set the maximum angle of a slope that the player can climb. Slopes steeper than this angle will block the character. A value of 0 means the character can only move on a perfectly flat surface, while higher values allow climbing steeper slopes. A value of 60 degrees (the default in most configurations) allows traversing moderately steep terrain.
 
 ### Change the character speed
 

docs/gdevelop5/behaviors/topdown/index.md

@@ -37,6 +37,22 @@ By default, the facing angle of our sprite is 0 which is the right side of our s
 !!! note
 
     Note that some expressions like `AngleBetweenPositions` can gives you a result between -180 and 180. This is equivalent to this schema. An angle of -45 degrees is equivalent to an angle of 270 degrees.
+
+####  Viewpoint (for isometric games)
+
+The **Viewpoint** property controls how movement directions are projected onto the screen. This is essential for isometric games where the visual perspective differs from the movement plane.
+
+* **Top-Down** (default): Movement directions map directly to screen axes. Moving right moves the object right on screen.
+* **Isometry 2:1**: Uses a classic pixel isometry projection (approximately 26.6°), the style common in many retro strategy games. The movement directions are transformed so that "forward" on screen matches the isometric visual perspective.
+* **True Isometry (30°)**: Uses a mathematically perfect 30-degree isometric projection.
+* **Custom Isometry**: Allows specifying any isometry angle, useful for non-standard perspectives.
+
+When using an isometric viewpoint, it is also recommended to set the **Movement angle offset** to **-45 degrees**. This rotates the input directions so that pressing "up" moves the character toward the top of the isometric view rather than straight up on screen.
+
+!!! tip
+
+    See the **Isometric Game** example below for a working demonstration of how to combine the Isometry viewpoint with the movement angle offset.
+
 ####  Allows diagonals
 
 ![](allow-diagonals-box.png)
@@ -67,6 +83,8 @@ The "top-down multitouch controller mapper" behavior from the [multi-touch joyst
 
 By default, our object will rotate toward the direction of movement. The object will rotate at the speed we specify in the Rotation speed option. If we don't want the object to rotate, we need to disable this by unchecking the box.
 
+For characters that face different directions using separate animations rather than rotation (for example, a top-down RPG character with separate walk-left and walk-right animations), disable rotation and use the movement angle expression to determine which animation to play with events.
+
 All theses values can also be changed at any time during the game using [events](/gdevelop5/events).