AudioEffectEQ21 in Godot – Complete Guide

Welcome to an exciting exploration into the world of sound manipulation with Godot’s AudioEffectEQ21. As game developers, we understand that audio plays a pivotal role in creating immersive and dynamic environments for players. Learning how to wield this powerful tool will not only enhance your game’s auditory experience but also provide you with fine-grained control over how sound interacts with your player’s journey. So buckle up, and let’s dive into the intricacies of the AudioEffectEQ21 class in Godot 4.

What is AudioEffectEQ21?

The AudioEffectEQ21 is a comprehensive 21-band equalizer audio effect that can be added to an audio bus in Godot 4. It’s part of Godot’s rich audio processing framework, which enables developers to finely tune the audio in their games. With the ability to control frequencies ranging from 22 Hz to 22 kHz, this particular effect boasts precise modulation for each band between -60 and +24 dB, opening up a vast landscape for audio design.

What is it for?

This audio effect is used to enhance and shape the sound within a game by adjusting individual frequency bands. You can create different audio profiles for varied environments, characters, or actions. Whether you’re ramping up the bass for an epic boss battle or smoothing out highs for a serene landscape, the AudioEffectEQ21 allows you to fine-tune your sound to fit any scenario.

Why Should You Learn It?

Becoming proficient with the AudioEffectEQ21 in Godot can significantly level up your game development skills. Not only do you gain the power to amplify the emotional impact of your game’s audio, but it also distinguishes your work through polished and dynamic soundscapes. For anyone looking to create memorable and high-quality gaming experiences, understanding how to implement and utilize this audio effect is indispensable.

CTA Small Image

Setting Up the AudioEffectEQ21 in Godot

Before diving into specific examples of using AudioEffectEQ21, let’s ensure it’s set up correctly in your project. Here’s a step-by-step guide to get you started:

# Step 1: Create a new Audio Bus

# Step 2: Add the AudioEffectEQ21 to the new Bus
var eq =
AudioServer.add_bus_effect(bus_layout.find_bus_index("MyEQBus"), eq)

With the audio bus and effect in place, you can now refer to this setup in your scripts or within the Godot editor to apply the equalizer to any audio source in your game.

Configuring the AudioEffectEQ21 Bands

Each band in the AudioEffectEQ21 can be configured individually. Here’s an example on how to access and modify these bands through code:

# Assuming 'eq' is the instance of your AudioEffectEQ21
eq.set_band_gain_db(0, -10) # Reduce the gain at 22 Hz by 10 dB
eq.set_band_gain_db(10, 5)  # Increase the gain at 1 kHz by 5 dB
eq.set_band_gain_db(20, -5) # Reduce the gain at 22 kHz by 5 dB

By manipulating each band’s gain, you can sculpt the audio to achieve the desired effect. Experiment with various settings to understand how changes affect the overall sound.

Creating a Bass Boost Effect

Let’s say you want to enhance the lower frequencies in a character’s theme to reflect their powerful presence. You can emphasize the bass by increasing the gain on the lower frequency bands like this:

# Apply a simple bass boost
for i in range(0, 7): # Boosting the first 7 bands, generally representing the bass frequencies
    eq.set_band_gain_db(i, eq.get_band_gain_db(i) + 3)

Your character’s theme now carries more weight, helping to solidify their formidable persona.

Creating an Atmospheric Reverb Effect

For creating an atmospheric effect, you may want to couple the AudioEffectEQ21 with reverb. First, apply subtle modifications to the EQ then add a reverb effect:

# Subtle EQ tweaks for atmosphere
eq.set_band_gain_db(20, -3) # Slightly reduce highest frequencies for a softer sound

# Add a reverb effect to the bus
var reverb =
AudioServer.add_bus_effect(bus_layout.find_bus_index("MyEQBus"), reverb)

# Configure reverb parameters
reverb.room_size = 0.8
reverb.damp = 0.5
reverb.wet = 0.6

Now you’ve created an environment that feels larger and more ethereal, perfect for cavernous spaces or mystical forests.

Tailoring Audio for Action Scenes

During intense action scenes, you might want high frequencies to cut through the mix for better clarity. Here’s how to achieve that:

# Boost higher frequencies to make action sounds more pronounced
for i in range(14, 21): # Considered as higher frequency bands
    eq.set_band_gain_db(i, eq.get_band_gain_db(i) + 2)

This elevation helps the sound of sword clashes and quick movements stand out, adding to the excitement of the moment.

Remember to adjust these examples to fit the unique audio profile of your game. In the next part, we’ll continue exploring practical applications for AudioEffectEQ21 to further enrich your game’s soundscape.

Continuing with the capabilities of the Godot AudioEffectEQ21, we’ll dive deeper into practical applications and provide additional code examples to help illustrate how to effectively employ this tool in various gaming scenarios. By learning to manipulate sound with precision, you have the ability to fine-tune your game’s audio, achieving a professional and captivating auditory experience.

Enhancing Clarity in Voice-Over and Dialogue

Ensuring that dialogue is clear and stands out against background music and sound effects is essential. Here’s how you can emphasize the midrange frequencies that are typical of the human voice:

# Emphasize the human voice frequency range (typically around 300 Hz to 3 kHz)
for i in range(6, 13):
    eq.set_band_gain_db(i, eq.get_band_gain_db(i) + 2)

This tweak ensures that voice-over and dialogues cut through the mix, essential for storytelling and player instructions.

Reducing Audio Fatigue

Long play sessions can lead to audio fatigue, especially with harsh frequencies. To mitigate this, you can soften the high-mid frequencies:

# Soften high-mid frequencies to ease listener fatigue over time
for i in range(11, 16):
    eq.set_band_gain_db(i, eq.get_band_gain_db(i) - 2)

Your players will thank you for a more comfortable and enduring audio experience.

Simulating Different Environments

The ability to simulate different listening environments can greatly enhance immersion. For instance, to mimic the acoustics of a small room, you might slightly reduce bass frequencies and boost the mids:

# Simulate the acoustics of a small room
eq.set_band_gain_db(0, -5) # Reduce lower frequencies
eq.set_band_gain_db(5, 4)  # Boost mid frequencies slightly
eq.set_band_gain_db(10, -2) # Cut some of the higher mids

This EQ setting can help create the intimate feel of being in a closed or smaller space.

Creating Tension with Sound

During suspenseful moments, you can enhance the tension by making high and low frequencies more prominent and reducing the mids:

# Create tension by exaggerating highs and lows
eq.set_band_gain_db(1, 5)   # Boost low-end frequencies
eq.set_band_gain_db(10, -10) # Significantly cut mids
eq.set_band_gain_db(20, 5)  # Boost high-end frequencies

This audio profile can make players feel unease, enhancing the suspense in your game.

Adjusting EQ in Real-Time for Dynamic Effects

Audio in games can be even more dynamic if you adjust the EQ in real-time. The following example shows how to increase bass gradually, perhaps as a player approaches a large, threatening creature:

# Assuming we have a function that is called as the player approaches the creature

func increase_bass_approach_creature(distance_to_creature):
    var gain_increase = max(0, 5 - (distance_to_creature / 10)) # Calculate the gain based on distance
    eq.set_band_gain_db(0, gain_increase) # Apply this gain to the lowest frequency band

Using such a technique allows for an adaptive audio experience that responds to in-game events or player actions.

Avoiding Overlap with Sound Effects

Sometimes you need to avoid frequency clashes with sound effects, such as footsteps or environmental noises. By cutting specific bands, you can create room for these effects:

# Avoid overlap with important sound effects, e.g., footsteps
eq.set_band_gain_db(6, -3) # Reduce some lower-mid frequencies
eq.set_band_gain_db(14, -4) # Cut a bit of the higher mids where the footstep 'click' might reside

Creating such an EQ pocket ensures that sound effects remain distinct and audible.

These examples illustrate the flexibility and creative potential of the AudioEffectEQ21 in Godot. As you incorporate these techniques into your own projects, remember, just like any other aspect of game design, audio requires careful iteration and fine-tuning to achieve the best results. With Godot’s AudioEffectEQ21, the sound of your game is literally at your fingertips, limited only by your imagination and your understanding of how sound can shape the gaming experience.Adjusting audio parameters not only contributes to an immersive gaming experience but also can be used as a tool for storytelling and gameplay mechanics. Here, we’ll delve deeper into Godot’s AudioEffectEQ21 and explore more advanced techniques with additional code examples.

When you want to convey a sense of speed or motion, you could progressively shift the EQ to emphasize higher frequencies. For instance, as a player’s car accelerates, the engine’s roar should mirror that sense of gathering speed:

func update_engine_sound_speed(speed):
    var high_freq_gain = clamp(speed / 50, 0, 6) # Assuming max speed is scaled to match the gain range
    for i in range(14, 21): # Only manipulate the higher frequencies
        eq.set_band_gain_db(i, high_freq_gain)

In atmospheric storytelling, environmental sounds can signal changes in the narrative. Imagine a scene transitioning from an open field to a dense forest; the EQ could help achieve this transition:

func transition_to_forest(transition_progress):
    eq.set_band_gain_db(1, lerp(eq.get_band_gain_db(1), -5, transition_progress)) # Less bass
    eq.set_band_gain_db(10, lerp(eq.get_band_gain_db(10), 3, transition_progress)) # More mid-range presence
    eq.set_band_gain_db(20, lerp(eq.get_band_gain_db(20), -2, transition_progress)) # Subtle high-end roll-off

Modulating the game’s soundtrack towards the player’s health status can also be a compelling feature. As the player’s health declines, you may want the music to reflect their peril:

func adjust_music_for_health(player_health):
    var health_percentage = player_health / 100.0 # Assuming max health is 100
    var low_health_tension = 1.0 - health_percentage # Inverse relationship for added tension
    for i in range(0, 4): # Boost lower frequencies for an ominous feel
        eq.set_band_gain_db(i, eq.get_band_gain_db(i) + low_health_tension * 3)
    for i in range(5, 10): # Reduce mid frequencies to create a hollow effect
        eq.set_band_gain_db(i, eq.get_band_gain_db(i) - low_health_tension * 2)

Understanding and responding to player actions is another level of dynamic audio. Imagine a platformer game where the player can activate a power-up mode. The EQ can be used to enhance that experience:

func activate_power_up_mode(is_active):
    if is_active:
        for band_index in range(0, 21): # Slight overall boost for power-up
            eq.set_band_gain_db(band_index, eq.get_band_gain_db(band_index) + 1)
        for band_index in range(0, 21): # Return to normal EQ levels
            eq.set_band_gain_db(band_index, eq.get_band_gain_db(band_index) - 1)

Films often use the effect of muffled sound to indicate characters are underwater. You can replicate this effect by rolling off both the highs and lows in the EQ:

func simulate_underwater_effect(is_underwater):
    if is_underwater:
        for i in range(0, 5): # Reduce lower frequencies
            eq.set_band_gain_db(i, -10)
        for i in range(15, 21): # Reduce higher frequencies
            eq.set_band_gain_db(i, -10)
        for i in range(0, 5): # Return to standard EQ for normal environment        
            eq.set_band_gain_db(i, 0)
        for i in range(15, 21): # Return to standard EQ for normal environment
            eq.set_band_gain_db(i, 0)

Finally, creating an aural contrast between two worlds can be achieved with EQ switching. If a player moves between a cyberpunk city and a calm countryside, the EQ settings could reflect such a drastic environmental change:

func toggle_world_audio(world_type):
    match world_type:
            # Increase lows and highs for a technological feel
            eq.set_band_gain_db(1, 4)  # Boost low frequencies
            eq.set_band_gain_db(20, 5) # Boost high frequencies
            # More emphasis on mids for a natural, open-air sound
            eq.set_band_gain_db(10, 3) # Boost mid frequencies
            # Reset other bands to their neutral state (assumed 0 dB)
            eq.set_band_gain_db(1, 0)  # Reset low frequencies
            eq.set_band_gain_db(20, 0) # Reset high frequencies

Applying these sound design principles using the AudioEffectEQ21 in Godot allows you to craft a more expressive and interactive gaming experience. As developers and composers align their creative visions, sound becomes a dynamic force that goes beyond mere background and becomes a living part of the game environment, reacting and adapting to the players’ journey. Try integrating these sonic elements into your projects, and you’ll soon see how they add depth and engagement to the player’s experience.

Where to Go Next with Your Game Development Journey

If you’re excited about the possibilities that Godot’s AudioEffectEQ21 has opened up for you, keep the momentum going by diving deeper into the world of game development. We at Zenva are here to guide you on this creative path with our comprehensive Godot Game Development Mini-Degree. This program is tailored to equip you with the skills necessary to create stunning cross-platform games using the powerful and user-friendly Godot 4. Whether you’re a beginner or an experienced dev looking to expand your repertoire, our mini-degree covers a breadth of topics to enhance your expertise.

You’ll learn about 2D and 3D asset implementation, master GDScript, grasp intricate gameplay control flows, and explore different gaming mechanics across various genres — all at your own pace. On top of that, completing these courses will not only level up your skills but also help you to build an impressive portfolio of Godot projects, paving the way for a career in game development.

For those who desire to explore beyond and delve into specific topics, our wider array of Godot courses will provide you with all you need to continue your education in game development. Here at Zenva, we are passionate about empowering you to turn your game ideas into reality. Begin your journey today, and see where your creativity takes you!


With the power-packed features of Godot’s AudioEffectEQ21 at your command and your newfound knowledge on how to use it, you’re equipped to elevate the auditory realms of your gaming worlds. The journey doesn’t end here, though. Every bit of learning is a step towards mastering the craft of game development. We encourage you to keep experimenting, fine-tuning, and bringing your game’s soundscape to life in ways only you can imagine.

As you continue to push the boundaries of what’s possible within Godot and beyond, remember that we at Zenva are here for your journey every step of the way. Dive deeper into your game development adventure with our Godot Game Development Mini-Degree and acquire the cutting-edge skills that will set your creations apart. The world is waiting to experience your next great game – let’s make it happen.

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.