/godot-version-migration

Migration notes: godot-audio-systems

Incremental upgrade for topics this skill covers. Apply one hop, stabilize/test, then next. Never skip hops.

If the project is < 4.0, follow godot-version-migration era bridges (legacy → 3→4) until 4.0, then these hops. Official 3→4: Upgrading from Godot 3 to Godot 4.

3.x → 4.0

Official: Upgrading from Godot 3 to Godot 4

• Bus/effects model already 3.x-shaped; still re-validate players after convert.
• Listener → AudioListener3D; positional players renamed with 2D/3D suffixes where applicable.
• VideoPlayer → VideoStreamPlayer.
• Re-check AudioServer.device → output_device.

4.0 → 4.1

Official: Upgrading to Godot 4.1

No skill-relevant breaking changes for this hop.

4.1 → 4.2

Official: Upgrading to Godot 4.2

No skill-relevant breaking changes for this hop.

4.2 → 4.3

Official: Upgrading to Godot 4.3

• AudioStreamPlaybackPolyphonic.play_stream() gains playback_type and bus optionals — route layered SFX without extra player nodes.

4.3 → 4.4

Official: Upgrading to Godot 4.4

No skill-relevant breaking changes for this hop.

4.4 → 4.5

Official: Upgrading to Godot 4.5

No skill-relevant breaking changes for this hop.

4.5 → 4.6

Official: Upgrading to Godot 4.6

No skill-relevant breaking changes for this hop.

4.6 → 4.7

Official: Upgrading to Godot 4.7

• AudioEffectSpectrumAnalyzer.tap_back_pos removed — migrate visualizer/equalizer tutorials to current analyzer tap APIs.
• AudioStreamPlayer.area_mask default is 0 (disabled; was layer 1) — explicitly set area_mask to your Area audio layer when using Area2D/Area3D audio_bus_override.