From 8956545d3cb18c1f3ae180e2462e14fa5e4b6b89 Mon Sep 17 00:00:00 2001
From: VinPropane <don@donmail.org>
Date: Sun, 5 Apr 2026 15:02:13 -0400
Subject: [PATCH] NS-23: Document idle skip vs is_on_floor / move_and_slide

---
 client/scripts/player.gd | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/client/scripts/player.gd b/client/scripts/player.gd
index 1ca6a66..2d5078e 100644
--- a/client/scripts/player.gd
+++ b/client/scripts/player.gd
@@ -58,6 +58,8 @@ func _set_horizontal_velocity_toward(point: Vector3) -> void:
 	velocity.y = 0.0
 
 
+## `is_on_floor()` comes from the last `move_and_slide()`. Skipping slide while idle reuses that
+## stale floor state — OK for static floors; revisit if walkable geometry moves.
 func _skip_move_when_idle_on_floor() -> bool:
 	return is_on_floor() and velocity.length_squared() < 1e-12