From c9d4c33174c87ede1f49c5fe5e8e49a784798eb6 Mon Sep 17 00:00:00 2001
From: Zughy <63455151+Zughy@users.noreply.github.com>
Date: Sun, 7 Sep 2025 20:44:48 +0200
Subject: [PATCH] Docs: clarify `stepheight` upper limit

---
 doc/lua_api.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/lua_api.md b/doc/lua_api.md
index 5fdc0b52d0..ca0ca20359 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -9558,7 +9558,8 @@ Player properties need to be saved manually.
     stepheight = 0,
     -- If positive number, object will climb upwards when it moves
     -- horizontally against a `walkable` node, if the height difference
-    -- is within `stepheight`.
+    -- is within `stepheight` and if the object current max Y in the world
+    -- is greater or equal than the node min Y.
 
     automatic_face_movement_dir = 0.0,
     -- Automatically set yaw to movement direction, offset in degrees.