ReflectionProbe in Godot – Complete Guide

Reflecting reality in a virtual environment is an intricate game of trickery. One second you’re marveling at the realistic surfaces in your favorite game, and the next, you discover it’s all an illusion crafted by clever techniques and algorithms. Reflection probes are one of these magical tools, particularly in the ecosystem of Godot 4, that help bring digital worlds to life with convincing reflections. Let’s dive into the art of creating realistic reflections in 3D scenes using the ReflectionProbe class, and see how this can amplify the visual fidelity of your projects while maintaining performance.

What is ReflectionProbe?

A ReflectionProbe is a node in Godot Engine that captures its surroundings to create cubemaps. These are snapshots of the environment from a specific point in space, processed to simulate how light reflects on different surfaces. In essence, they’re like 3D mirrors that can show real-time or static reflections in your game, making everything more immersive and visually engaging.

What is it for?

Reflection probes are instrumental for creating environmental realism. They’re used for a variety of surfaces, such as glossy floors, metallic objects, and water bodies. By accounting for how light interacts with different materials, reflection probes add depth to a scene, give cues about spatial relationships, and enhance the atmosphere of your virtual creations.

Why Should I Learn to Use ReflectionProbe?

Understanding how to use ReflectionProbe not only allows you to add a layer of polish and sophistication to your 3D scenes but also provides the following advantages:

– **Efficiency**: ReflectionProbe can create accurate reflections with a lower performance cost compared to real-time global illumination.
– **Quality**: They support different levels of blur to simulate material roughness, adding realism to different types of surfaces.
– **Flexibility**: ReflectionProbes can be updated strategically to balance between quality and performance, and they can blend smoothly with other elements in the scene.

In learning how these probes work, you’ll gain more control over the visual output of your game without necessarily sacrificing framerate – an essential skill for any game developer.

CTA Small Image

Creating ReflectionProbes in Godot 4

First, let’s create a simple ReflectionProbe in your Godot 4 project. This basic example will introduce you to the setup process.

var probe =

probe.translation = Vector3(0, 1, 0) // Position your probe where you need it
probe.extents = Vector3(10, 10, 10) // Set the size to reflect the environment

Next, you’ll want to configure the reflection update mode. You can choose to have the probe update its capture continuously, only once, or manually when you decide to.

probe.update_mode = ReflectionProbe.UPDATE_ONCE // Options: UPDATE_ONCE, UPDATE_ALWAYS, UPDATE_WHEN_VISIBLE

Setting the intensity of the reflections helps to blend them with the rest of the lighting in your scene.

probe.intensity = 0.8 // A value between 0 and 1, with 1 being the most intense.

Finally, for optimization purposes, you can choose to use box projection which will make reflections look more correct inside square rooms or areas, and less stretched on the edges.

probe.use_box_projection = true // Set to true for box-like environments

Adjusting Material Properties

Materials in your scene need to be set up to interact with reflections. Here’s how to make a surface reflective:

var material =

material.params_use_ssr = true // SSR stands for Screen Space Reflections
material.reflection = 0.5 // A value between 0 (no reflection) and 1 (full mirror-like reflection)

var mesh_instance =
mesh_instance.material_override = material

If you have an object that should reflect the environment but not be used to calculate the reflection capture (like moving objects), you can exclude them from the probe.

mesh_instance.render_layer_mask = 0 // This object won't be considered in the reflection probe

Adjust a material’s `roughness` property to control how sharp or blurred the reflection is. A lower value will give you a more mirror-like reflection, while higher values create a blurrier, more diffused look.

material.roughness = 0.1 // Lower is sharper; a value closer to 1 is blurrier

You can also adjust the metallic property which influences how much the material reflects the environment. A non-metallic material will still reflect light but uses its base color more, while a metallic material will reflect nearly all light as environment reflections.

material.metallic = 0.8 // Higher values simulate metal better

By fine-tuning these properties, you can achieve a wide range of visually stunning effects that make your game environments feel more dynamic and realistic. Stay tuned for the next part of our tutorial where we’ll dive into more complex setups and optimizations for ReflectionProbes in Godot 4!

Optimizing ReflectionProbes for Performance

Reflection probes can be demanding on performance, particularly in complex scenes or on lower-end hardware. To maintain a good balance between visual fidelity and performance, it’s essential to use optimization techniques. Here are some ways to optimize ReflectionProbes in your Godot 4 project:

Culling Mask Optimization

Control which objects are reflected and which are not by adjusting the culling mask of the ReflectionProbe. This can improve performance by excluding objects that don’t contribute significantly to the reflection.

probe.cull_mask &= ~(1 << layer) // Exclude layers from being reflected

ReflectionProbe Blend Distance

By adjusting the blend distance, you can determine how reflections from different probes blend together. Smaller blend distances give you sharper transitions between reflections, which can be useful for distinct areas.

probe.blend_distance = 1.5 // Determines the blend area around the probe extents

Limiting Update Frequency

If your scene’s lighting conditions don’t change often, you can limit the frequency at which the ReflectionProbe updates its capture. This will save a significant amount of GPU resources.

probe.update_mode = ReflectionProbe.UPDATE_ONCE // Or script control for manual updates

Using Lower Resolution

Lowering the resolution of the cubemap generated by the ReflectionProbe can yield better performance. You can balance between quality and performance by adjusting this value.

probe.resolution = 256 // Lower resolution leads to performance gains

Advanced ReflectionProbe Techniques

Blending Multiple Probes

In larger or more complex scenes, you’ll likely need to use multiple reflection probes. Carefully position and blend them to ensure smooth transitions.

probe1.blend_distance = 0.5
probe2.blend_distance = 0.5
// Place probes strategically to cover different areas of your scene

Integrating with Shader Code

For ultimate control and custom reflection effects, you can reference ReflectionProbes within your shader code. You can fetch reflection data and manipulate it for custom materials.

// In a shader, you might access the reflection texture like this
uniform samplerCube reflection_probe;
vec3 reflected_color = texture(reflection_probe, REFLECT(vec3(0.0), normal)).rgb;

Environmental Reflection Adjustments

Control how much of the environment versus local reflections are used on a material. Adjusting this can help in scenarios where you want to emphasize reflections from certain parts of your environment.

material.reflection_probe_mix = 0.8 // Mix local and environmental reflections

By incorporating these techniques, you can achieve detailed and realistic reflections in your Godot 4 projects while also taking into consideration the constraints of your target platform or device. Remember to adjust settings and test your scene in different conditions to find the perfect balance for your needs. Happy reflecting!ReflectionProbes can play a significant role in both improving the visual richness and the performance of your Godot 4 projects. Harnessing ReflectionProbes effectively depends heavily on how well you’re leveraging Godot’s powerful features. Here are some additional code examples and pieces of information that will help you continue enhancing your scenes with ReflectionProbes.

ReflectionProbe and Sky Contribution

Reflection probes can also capture and reflect the sky. You can adjust the intensity of the sky reflection separately, which can be particularly useful in outdoor scenes or for objects that should predominantly reflect the sky.

probe.sky_contribution = 0.5 // A value from 0 to 1 determining sky intensity

This sets the reflection probe to account for half its reflection detail from the sky, blending it with local geometry reflections.

Adjusting Reflection Probe Bounds

To further control the reflection effect, you can adjust the extents or ‘bounds’ of your ReflectionProbe. This is especially useful for probes situated in confined spaces like rooms or corridors.

probe.extents = Vector3(5, 3, 10) // Adjust this Vector3 to fit your scene's dimensions

Configuring the extents accurately ensures that the reflections are gathered from the correct area and contribute to scene realism.

Interior Reflections and Clipping

For scenes that contain interior spaces, it is often necessary to clip the reflections to the confines of the room to prevent outside objects from affecting the reflection texture.

probe.use_box_projection = true
probe.extents = Vector3(3, 2, 3) // Assume these are the half-dimensions of your room
probe.origin_offset = Vector3(0, -1, 0) // Adjust if the probe's center isn't the room center

The `use_box_projection` boolean, when set to true, helps ReflectionProbes emulate reflections within an enclosed space more accurately.

Real-Time and Baked Reflections

You can choose between real-time or baked reflections. Baked reflections don’t change and are typically precomputed in the editor or through a script, reducing runtime calculations.

// To bake reflections in the editor:
probe.update_mode = ReflectionProbe.UPDATE_ONCE

// To bake reflections through a script:

Baking reflections is ideal for static scenes or those with limited dynamic lighting changes. This can be a significant optimization.

Incorporating Reflections in Custom Shaders

When you’re writing custom shaders, you might want to include reflections. You can access the `reflection` built into Godot Shader Language like so:

shader_type spatial;
void fragment() {
    vec3 reflection_vec = reflect(-VIEW, NORMAL);
    vec4 reflected_color = texture(reflection_texture, reflection_vec);

In the shader, `reflection_texture` is a built-in uniform that provides the texture to use for reflections, and `reflection_vec` is the direction vector for reflected light, computed by reflecting the view vector against the normal.

Putting It All Together

Creating a comprehensive reflection system involves combining various properties and optimizing their performance in Godot 4.

// Example: Setting up and optimizing a ReflectionProbe node
var probe =
probe.extents = Vector3(4, 4, 4)
probe.update_mode = ReflectionProbe.UPDATE_ALWAYS
probe.intensity = 0.5
probe.use_box_projection = true
probe.origin_offset = Vector3(0, 1, 0)
probe.cull_mask = 0b1111111111111110 // Reflect all layers except the second to last
probe.bake() // Optionally, bake the probe for static scenes

The probe in this example will capture reflections in real-time, with a moderate intensity and box-delimited to its specified extents. It excludes specific layers from its capture to avoid unwanted reflections and optimizes its performance by baking the reflections if the scene is static.

By integrating these strategies, Godot developers can create compelling and visually striking 3D scenes that run efficiently on a variety of platforms. Remember, the path to mastering reflections in Godot involves experimentation and iteration. Test different settings and observe how they affect both the visuals and performance of your game. Happy coding!

Continue Your Godot Journey with Zenva

You’ve taken a remarkable step in exploring the world of reflections in Godot 4. We hope it sparked new ideas and excitement for creating stunning virtual worlds. But don’t let the momentum stop here! To dive deeper and expand your Godot prowess, we encourage you to check out our Godot Game Development Mini-Degree. This program is designed to give you a well-rounded education in game development using this powerful and user-friendly engine.

Whether you’re just starting out or looking to polish your skills with advanced concepts, our Mini-Degree is tailored to support learners at all levels. You’ll build a solid foundation and work on hands-on projects that’ll spice up your portfolio. And for those seeking to broaden their knowledge even further, explore our full suite of Godot courses. Transform your passion for game creation into real, versatile skills with Zenva, where we commit to supporting your journey every step of the way.


Mastering ReflectionProbes in Godot 4 is just the beginning of an exhilarating journey into game development. The skills you acquire and refine here not only enhance your ability to create visually captivating scenes but also give you insights into efficient game design. We’re thrilled to be part of your learning experience and can’t wait to see the worlds you’ll bring to life. Never stop creating, experimenting, and pushing the boundaries of what’s possible in virtual spaces.

Ready to take your Godot skills to the next level? Join us at Zenva and discover an array of courses that will empower you to become the game developer you aspire to be. Check out our Godot Game Development Mini-Degree and become a part of a community that’s passionate about crafting incredible gaming experiences. Unleash your creativity — your game development adventure is just one click away!

Python Blog Image

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