Implement Parallax Scrolling Background linked to Player Speed

scenes/main_scene.tscn

@@ -1,4 +1,4 @@
-[gd_scene load_steps=82 format=3 uid="uid://nnnc0qhx07i8"]
+[gd_scene load_steps=83 format=3 uid="uid://nnnc0qhx07i8"]
 
 [ext_resource type="Script" uid="uid://ctm7qg12s2swt" path="res://scripts/main_scene.gd" id="1_7ykc4"]
 [ext_resource type="PackedScene" uid="uid://cb4n4cqkuddqg" path="res://scenes/pause_menu.tscn" id="1_w2twt"]
@@ -77,6 +77,7 @@
 [ext_resource type="Texture2D" uid="uid://bvxu5x1awjrjv" path="res://files/random_decor/dirt_001.png" id="69_7tyuc"]
 [ext_resource type="Texture2D" uid="uid://f4hxu68qa4fi" path="res://files/random_decor/dirt_002.png" id="70_isor2"]
 [ext_resource type="Script" uid="uid://blu5qujicfa7e" path="res://scripts/hud.gd" id="72_sgkfd"]
+[ext_resource type="Script" uid="uid://b5x2ehdthhrla" path="res://scripts/parallax_manager.gd" id="76_qj6t7"]
 
 [sub_resource type="StyleBoxFlat" id="StyleBoxFlat_pu3yx"]
 bg_color = Color(0.2627451, 0.2627451, 0.2627451, 0.5882353)
@@ -204,6 +205,7 @@ step = 1.0
 [node name="PauseMenu" parent="." instance=ExtResource("1_w2twt")]
 
 [node name="Background" type="ParallaxBackground" parent="."]
+script = ExtResource("76_qj6t7")
 
 [node name="Sand" type="ParallaxLayer" parent="Background"]
 

scripts/main_scene.gd

@@ -1,4 +1,4 @@
-## Copyright (C) 2025 Egor Kostan
+## Copyright (C) 2026 Egor Kostan
 ## SPDX-License-Identifier: GPL-3.0-or-later
 ## main_scene.gd
 ## Main scene script for SkyLockAssault.
@@ -52,6 +52,12 @@ func _ready() -> void:
 	# Setup decor layer with random instances
 	setup_decor_layer(viewport_size)
 
+	# Wire up the signal architecture for the parallax background
+	if player.has_signal("speed_changed") and background.has_method("_on_player_speed_changed"):
+		player.speed_changed.connect(background._on_player_speed_changed)
+		# Prime the background with the player's initial starting speed
+		background._on_player_speed_changed(player.speed["speed"], 0.0)
+
 
 # 2. Detect when player presses a key/button that has NO binding at all
 # Only significant inputs (axes above deadzone) are checked to prevent
@@ -227,12 +233,12 @@ func _process(delta: float) -> void:
 		return
 
 	# Use the safe local reference for difficulty
-	var scroll_speed: float = player.speed["speed"] * delta * settings_res.difficulty * 0.8
-	background.scroll_offset.y += scroll_speed
+	# var scroll_speed: float = player.speed["speed"] * delta * settings_res.difficulty * 0.8
+	# background.scroll_offset.y += scroll_speed
 
 	# Use the safe local reference for current_fuel
-	if settings_res.current_fuel <= 0:
-		background.scroll_offset = Vector2(0, 0)
+	# if settings_res.current_fuel <= 0:
+	#	background.scroll_offset = Vector2(0, 0)
 
 	# 1. Critical unbound controls warning (shown ONCE per session)
 	# Flag stays true until player fixes bindings (e.g., in key_mapping.gd after remap).

scripts/parallax_manager.gd

@@ -0,0 +1,33 @@
+## Copyright (C) 2026 Egor Kostan
+## SPDX-License-Identifier: GPL-3.0-or-later
+## parallax_manager.gd
+## Manages the scrolling speed of the parallax background based on player velocity.
+## Decoupled from direct physics polling via the Observer Pattern.
+
+class_name ParallaxManager
+extends ParallaxBackground
+
+var _current_speed: float = 0.0
+
+
+## Observer callback triggered when the player's speed changes.
+## Updates the internal speed used for parallax scrolling.
+## @param new_speed: float - The new forward speed of the player.
+## @param _max_speed: float - The maximum speed threshold (unused).
+## @return: void
+func _on_player_speed_changed(new_speed: float, _max_speed: float) -> void:
+	_current_speed = new_speed
+
+
+## Called every physics/rendering frame. Updates the vertical scroll offset
+## based on the cached player speed and current game difficulty.
+## @param delta: float - The elapsed time since the previous frame.
+## @return: void
+func _process(delta: float) -> void:
+	var difficulty: float = 1.0
+
+	if is_instance_valid(Globals) and is_instance_valid(Globals.settings):
+		difficulty = Globals.settings.difficulty
+
+	var scroll_amount: float = _current_speed * delta * difficulty * 0.8
+	scroll_offset.y += scroll_amount

scripts/parallax_manager.gd.uid

@@ -0,0 +1 @@
+uid://b5x2ehdthhrla