FogMaterial in Godot – Complete Guide

Welcome to the world of 3D game development with Godot 4, the eagerly anticipated update to the powerful open-source game engine! In today’s tutorial, we’ll delve into the mystical and atmospheric world of volumetric fog by exploring the capabilities of the FogMaterial class. Volumetric fog can truly elevate a game’s environment, creating depth, enhancing realism, and adding a touch of mystery to your scenes. Whether you’re a budding game developer or an experienced coder looking to expand your skills, understanding how to manipulate fog in Godot 4 could be an exciting addition to your repertoire.

What is the FogMaterial Class?

FogMaterial is a versatile resource in Godot 4 designed specifically for use with FogVolume nodes. It enables the creation of stunning volumetric fog effects that can enhance the ambiance and mood of any 3D scene.

What is it for?

Volumetric fog can play a crucial role in your game’s atmosphere. It can be used to simulate weather conditions, add depth to large environments, help with visual storytelling, or even to serve as a gameplay element in puzzles and exploration.

Why Should I Learn It?

Learning how to utilize Godot 4’s FogMaterial class will empower you to create more immersive and visually compelling game worlds. It adds a layer of polish that can make your 3D environments come to life. With a solid grasp on FogMaterial, your toolkit for game aesthetics and gameplay mechanics will expand, enabling you to craft unique gaming experiences that stand out.

CTA Small Image

Setting Up the FogVolume Node

Firstly, we need to add a FogVolume node to our scene. This node is the container for our fog effect where we apply our FogMaterial. Let’s set it up:

// Add a FogVolume node to your scene in the Godot Editor
// Select the FogVolume in the Scene Panel and in the Inspector,
// click on 'Material' to create a new FogMaterial

Once added, we can start adjusting the base properties of our FogMaterial:

// Make sure you have the FogVolume node selected to see these properties
// Set the 'density' property which controls how thick the fog is
// Adjust the 'albedo_color', which dictates the color of the fog
$fog_material.set_albedo_color(Color(0.8, 0.8, 0.8))

Customizing Fog Extinction and Scattering

The ‘extinction’ property influences how the fog diminishes with distance, while ‘scattering’ modifies how the fog interacts with light. Both of these properties significantly impact the realism of your fog effect.

// For a more realistic effect, set an 'extinction' value
// To have the fog react to your scene's lighting, adjust 'scattering'

Experiment with these values to see the changes they bring to the fog’s appearance in various lighting conditions in your game.

Creating Dynamic Fog with Animated Properties

You can animate FogMaterial properties to create dynamic effects such as rolling fog or changes in environment:

// Create a fog density animation to simulate denser fog rolling in
var animated_fog_density =
animated_fog_density.interpolate_property($fog_material, "density", 0.1, 0.2, 5, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
// Start the animation
// Similarly, animate the fog color to change over time, for instance, to simulate the time of day
var animated_fog_color =
animated_fog_color.interpolate_property($fog_material, "albedo_color", Color(0.8, 0.8, 0.8), Color(0.5, 0.5, 0.8), 10, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
// Start the animation

Applying FogMaterial to Varied Scene Ranges

Sometimes, you may want different areas of your scene to exhibit varying fog intensities. Use multiple FogVolume nodes with unique FogMaterial instances to achieve this effect.

// For example, you might want a heavy fog in a valley and a lighter fog on a hilltop
// Create a thicker fog material for the valley
var valley_fog_material =
$valley_fog_instance.material = valley_fog_material
// And a lighter fog material for the hilltop
var hilltop_fog_material =
$hilltop_fog_instance.material = hilltop_fog_material

By using these techniques, you can take full control of the atmospheric and ambient qualities of your 3D scenes in Godot 4. Stay tuned for our next installment where we will continue bringing our foggy scenes to life with more advanced examples and tips.Combining Fog with Environmental Effects can enhance the overall ambience of your scenes. For instance, adjusting the ‘height’ property allows the fog to only appear below a certain altitude, which can be useful for creating low-lying misty effects.

// Setting a lower 'height' makes the fog appear as if it's closer to the ground

On the other hand, with the ‘height_falloff’ property, you can control how quickly the fog effect fades out as you move vertically away from the ‘height’ level.

// A higher 'height_falloff' value will make the fog dissipate faster with altitude

Imagine creating a scene where the sun is rising, piercing through the morning fog. We can simulate this by animating the ‘sun_amount’ property of the FogMaterial depending on the angle and intensity of the sunlight.

// If you have a DirectionalLight simulating the sun, you could link its angle to the fog's 'sun_amount'
// This code could be part of a function that runs on a timer or during an animation
$fog_material.set_sun_amount(clamp(sun_light_node.rotation_degrees.x, 0.0, 1.0))

For games featuring dynamic weather systems, changing the ’emissive’ property dynamically can imitate fog glowing with light from the moon, streetlamps, or other sources.

// To have the fog slightly glow at night, you can adjust the 'emissive' property based on game time
if game_time.is_night():
    $fog_material.set_emissive(Color(0.2, 0.2, 0.3, 1.0))

And finally, for a more stylized effect, such as in a fantasy or sci-fi setting, you could colorize the fog based on player interactions, environmental changes, or story elements.

// If a player enters a magical area, change the fog color to something more mystical
$fog_material.set_albedo_color(Color(0.4, 0, 0.6))

Remember, when applying these dynamic effects, it’s vital to consider performance. Volumetric fog can be demanding, especially when used extensively or with high-quality settings. Always test your effects on your target platform to ensure a smooth gaming experience.

// To optimize performance, adjust the 'quality' property based on the platform or user settings
// This can also be hooked to a settings dialogue where the player can adjust graphic settings
$fog_material.set_quality(FogMaterial.QUALITY_LOW) # Alternatives include QUALITY_MEDIUM and QUALITY_HIGH

// Additionally, enabling 'use_noise' adds a random noise texture to the fog, giving it a more natural look
$fog_material.set_use_noise(true) // Be cautious as this can be more performance-intensive

These examples should give a solid foundation for incorporating dynamic volumetric fog into your Godot 4 game projects. Keep practicing and experimenting with different settings to find the perfect balance for your game’s atmosphere. Remember, the best way to learn is by doing, and every adjustment you make brings you one step closer to mastering the craft of creating immersive game environments. Happy developing!In this section, let’s dive into creating more sophisticated fog effects by combining Godot 4’s FogMaterial with other environmental features, control mechanisms, and animations to enrich our game’s visual storytelling.

Reacting to Player Proximity

Creating fog that dynamically reacts to a player’s proximity can create an immersive, responsive environment. Here’s how you might implement it:

// Detect player's distance to a certain point of interest where fog should be denser
var distance_to_player = foggy_point_of_interest.global_transform.origin.distance_to(player.global_transform.origin)
// Use the distance to adjust fog density accordingly
var adjusted_density = remap(distance_to_player, 0, 100, 0.2, 0.05)  // Closer to the point, denser the fog

Integrating with Weather Systems

For games with weather systems, fog density can be linked to the current weather conditions:

// Assuming you have a weather system that has a 'current_weather' state:
match weather_system.current_weather:

Using Timers for Fog Transitions

Timers can play a crucial role in smoothly transitioning fog properties. Here’s an example of using a timer to interpolate fog density over time:

// Using a Timer node to transition fog density from current to target value over a given duration
var timer =
timer.wait_time = 10.0  // Transition over 10 seconds
timer.one_shot = true  // Run the timer only once
var current_density = $fog_material.density
var target_density = 0.1  // The desired fog density after transition

// Connect the 'timeout' signal of the timer to a function that animates the property change
timer.connect("timeout", self, "_on_FogTransitionTimer_timeout")

func _on_FogTransitionTimer_timeout():
    $fog_material.interpolate_property($fog_material, "density", current_density, target_density, timer.wait_time, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)

Changing Fog with Altitude

To give a sense of higher density fog closer to the water bodies or lower ground, use the world space Y-coordinate to adjust fog density:

// Set fog density based on the Y-coordinate of a player or camera
var player_y = player.global_transform.origin.y
$fog_material.set_density(lerp(0.05, 0.2, clamp(player_y / sea_level, 0.0, 1.0)))

Underwater Fog Effects

If your game has underwater scenes, you can create a separate fog effect to simulate being submerged:

// You can check if the player is underwater and change the fog settings accordingly
if player.is_underwater:

Adjusting Fog Based on Camera Angle

For a stylistic touch, you can alter fog density based on the camera’s angle to simulate more complex atmospheric conditions:

// Calculate the camera's angle with the horizontal plane to adjust fog density
var camera_angle = camera.global_transform.basis.get_euler().x
var angle_based_density = remap(sin(camera_angle), -1, 1, 0.1, 0.2)

Concluding Notes

As you implement the code examples in your Godot 4 projects, remember that visual effects such as fog can greatly impact the player’s sense of immersion and the game’s mood. You now have the techniques to refine your FogMaterial usage further and craft an environment that keeps players engaged and absorbed in your game world. Keep on experimenting with these snippets, blend them together, and watch as your virtual landscapes transform with depth and atmosphere. Happy coding, and may your game worlds be as enigmatic and atmospheric as ever!

Continuing Your Game Development Journey

You’ve explored the atmospheric potential of volumetric fog with Godot 4, but the journey into game development is never-ending, filled with countless avenues to enhance your skills. If you’ve enjoyed bringing your game environments to life and are eager to dive deeper into the vast world of game creation, our Godot Game Development Mini-Degree is the perfect next step to escalate your prowess.

Whether you’re just starting out or looking to bolster your portfolio, these courses will walk you through the ins and outs of game development with Godot 4. From mastering 2D and 3D assets, ramping up your GDScript capabilities, to enriching gameplay with engaging mechanics across various genres like RPGs and survival games, our project-based courses are tailored to facilitate hands-on learning at your own pace, on any device. And if you’re thirsty for even more knowledge, feel free to explore our broad collection of Godot courses, catering to a diverse range of topics that will equip you with the skills needed to bring your game development dreams to fruition.

We at Zenva are committed to providing you with the high-quality content you need to transform from a beginner to a professional game developer. So why wait? Expand your abilities, craft compelling games, and build a solid foundation for a flourishing career in game development with us!


As we’ve journeyed through the ethereal realm of volumetric fog in Godot 4, we hope you’ve been inspired by the possibilities it unfolds for game atmosphere and design. Embrace these newfound skills to shape the worlds you imagine—worlds veiled in mist, brimming with mystery, and alive with player-driven stories. And this is simply the beginning; every technique you master lays another brick on the path to becoming an accomplished game developer.

Take the next bold step in your game development journey with our comprehensive Godot Game Development Mini-Degree, designed for aspiring creators ready to build their dreams into reality. Unlock your potential, and let’s continue crafting extraordinary gaming experiences together. The canvas is grand, and your adventure in game creation awaits!

Python Blog Image

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