Listener in Godot 4: it is AudioListener3D now
Listener is called AudioListener3D in Godot 4, and Listener2D is AudioListener2D. In a Godot 4 project, Listener.new() fails to parse with Identifier "Listener" not declared in the current scope. Did you mean to use "AudioListener3D"?.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
What Godot is checking
GDScript resolves every name when the script loads. Listener is not a class in Godot 4, so the analyzer stops before anything runs, and because the name is in Godot's own table of Godot 3 renames, the message names the replacement.
The converter carries Listener to AudioListener3D. Without one, 3D sound is heard from the current Camera3D; make_current() on an AudioListener3D moves the ears elsewhere, such as onto the player in a third-person game.
More on this: ClippedCamera in Godot 4: use a SpringArm3D with a Camera3D
Reproduce it
A Godot 3 script that creates a Listener in code, in a Godot 4 project.
extends Node
func _ready():
var listener = Listener.new()
print(listener)
What Godot 4.7.2 prints
More on this: SpatialMaterial in Godot 4: it is StandardMaterial3D now
Godot Engine v4.7.2.stable.mono.official.ed1daf0bf - https://godotengine.org
SCRIPT ERROR: Parse Error: Identifier "Listener" not declared in the current scope. Did you mean to use "AudioListener3D"?
at: GDScript::reload (res://answers/listener-in-godot-4/repro.gd:4)
ERROR: Failed to load script "res://answers/listener-in-godot-4/repro.gd" with error "Parse error".
at: load (modules/gdscript/gdscript_resource_format.cpp:46)Fix it
An AudioListener3D made current.
extends Node3D
func _ready() -> void:
var listener := AudioListener3D.new()
add_child(listener)
listener.make_current()
print(listener.get_class(), " current: ", listener.is_current())
What the fixed script prints
More on this: Position2D in Godot 4: it is Marker2D now
Godot Engine v4.7.2.stable.mono.official.ed1daf0bf - https://godotengine.org
AudioListener3D current: trueRun this fix with your agent
Flockbay is the Godot editor with an AI agent built in. Paste this into Flockbay's chat, or into Claude Code or Codex connected to Flockbay over MCP: the agent finds the cause in your project, applies the fix, runs the game headless and reads Godot's output to check it.
More on this: Particles2D in Godot 4: it is GPUParticles2D now
My Godot project was written for Godot 3 and Godot 4 stops on this: "Parse Error: Identifier "Listener" not declared in the current scope. Did you mean to use "AudioListener3D"?". Port every use to Godot 4. Listener is called AudioListener3D in Godot 4, and Listener2D is AudioListener2D. In a Godot 4 project, Listener.new() fails to parse with Identifier "Listener" not declared in the current scope. Did you mean to use "AudioListener3D"?. Then run the game headless and check Godot's output for errors.Verified on Godot 4.7.2
Both scripts on this page were run headless on Godot 4.7.2 (4.7.2.stable.mono.official.ed1daf0bf) on 18 October 2026, and the output above is what Godot printed, unedited.
Where the check lives in Godot's source: gdscript_analyzer.cpp line 4687, the message with its hint, renames_map_3_to_4.cpp line 1540, Listener to AudioListener3D, AudioListener3D class reference.
Questions
- Do I need an AudioListener3D at all?
- No. The current camera hears by default; add one only to hear from somewhere else.
- What is the 3D sound player called?
- AudioStreamPlayer3D, unchanged.
Flockbay's agent reads Godot's debugger output and fixes errors like this one in your project, on the official Godot.
Download Flockbay free