feat: implement movement state machine architecture and add various sound assets

movement/states/state_air.gd

@@ -100,11 +100,48 @@ func update(delta: float) -> void:
 			player.double_jump_player.play()
 		return
 
-	# ── Wall run transition ───────────────────────────────────────────────
-	var wall_n := machine.detect_wall_horizontal()
-	if wall_n != Vector3.ZERO and machine.input_dir.length() > 0.1 and machine.wall_cooldown_timer <= 0.0:
-		machine.switch_to("wall_run")
-		return
+	# ── Wall interaction (Run, Climb, Vault) ──────────────────────────────
+	if machine.input_dir.length() > 0.1 and machine.wall_cooldown_timer <= 0.0:
+		var fwd_wall = machine.detect_wall_forward()
+		if fwd_wall.hit:
+			if fwd_wall.is_short:
+				# Instant Vault
+				var look_dir := -player.global_transform.basis.z
+				var h_look := Vector3(look_dir.x, 0.0, look_dir.z)
+				if h_look.length_squared() > 0.01:
+					h_look = h_look.normalized()
+				player.velocity = h_look * params.wall_climb_vault_forward
+				player.velocity.y = params.wall_climb_vault_up
+				if player.vault_player:
+					player.vault_player.play()
+					
+				# Quick camera animation (tilt up and forward bob)
+				var camera = player.camera
+				if camera:
+					var tween = player.create_tween()
+					tween.tween_property(camera, "rotation_degrees:x", camera.rotation_degrees.x + 10.0, 0.15).set_trans(Tween.TRANS_SINE)
+					tween.parallel().tween_property(camera, "v_offset", -0.2, 0.15).set_trans(Tween.TRANS_SINE)
+					tween.chain().tween_property(camera, "rotation_degrees:x", camera.rotation_degrees.x, 0.2).set_trans(Tween.TRANS_SINE)
+					tween.parallel().tween_property(camera, "v_offset", 0.0, 0.2).set_trans(Tween.TRANS_SINE)
+					
+				machine.wall_cooldown_timer = 0.3
+				return
+			else:
+				# Check if moving directly into wall and looking generally towards it
+				var look_dir := -player.global_transform.basis.z
+				var looking_towards := look_dir.dot(-fwd_wall.normal) > 0.0
+				var moving_towards := wish_dir.dot(-fwd_wall.normal) > cos(deg_to_rad(params.wall_climb_max_angle))
+				
+				if looking_towards and moving_towards:
+					machine.wall_normal = fwd_wall.normal
+					machine.switch_to("wall_climb")
+					return
+		
+		# Fallback to wall run
+		var wall_n := machine.detect_wall_horizontal()
+		if wall_n != Vector3.ZERO:
+			machine.switch_to("wall_run")
+			return
 
 	# ── Dash ──────────────────────────────────────────────────────────────
 	if machine.input_dash: