godot-sync-parallax

Godot ParallaxLayer positions misalign when motion_scale is applied, causing the editor preview to differ from runtime rendering. This occurs because the editor does not automatically compute the inverse parallax offset needed to match the actual camera start position.

To fix ParallaxBackground layer positions in Godot 4, you need to apply an inverse parallax calculation that derives corrected editor positions from the desired runtime placement. This syncs the design-time visuals with the actual gameplay camera view.

Yes, this parallax sync tool works with Godot 4.x projects using ParallaxBackground with multiple layers. It automatically detects the camera start position and adjusts each ParallaxLayer to ensure editor design-time positions match gameplay.

Yes, you can automatically update Godot .tscn files to correct parallax layer offsets. The process computes corrected positions and writes them directly into the scene files, recording the changes via git commits for a minimal-disruption workflow.

The best way to calculate inverse parallax for motion_scale scenarios is to derive the editor-layer position from the desired runtime placement. This calculation accounts for the camera start position to ensure the initial runtime view aligns with the editor.

You should not use automated parallax position correction if your Godot project does not use ParallaxBackground with motion_scale, as standard layers without scaling offsets already match their editor preview positions at runtime.