AnimationNodeBlend3 in Godot – Complete Guide

Welcome to this comprehensive tutorial on the `AnimationNodeBlend3` class in Godot 4, a powerful game development engine that’s won hearts with its open-source dedication and user-friendly approach. Animation plays a crucial role in bringing games to life, and mastering it can transform a good game into a great one. Whether you’re a budding game developer or a seasoned programmer looking to sharpen your skills, understanding how to blend animations smoothly is essential. So, let’s dive into the world of animation blending in Godot and unlock new potentials for your characters and objects!

What is AnimationNodeBlend3?

The `AnimationNodeBlend3` class is a unique feature within Godot’s robust animation system. It operates within an `AnimationNodeBlendTree`, which is part of the more extensive `AnimationTree` – a feature that allows for complex animation states and transitions.

What is it for?

This resource is specifically designed to offer flexibility and control over how animations transition from one to another. By blending animations, you can create smooth transitions that make your character’s movements appear more realistic and less mechanical. This is particularly useful in situations where your game character needs to shift between different states, like walking and running or transitioning between different combat moves.

Why Should I Learn it?

Mastering `AnimationNodeBlend3` can significantly enhance the visual appeal of your game. Learning how to blend animations effectively means you can create a seamless gameplay experience for your players, making your game stand out. Moreover, the skills you pick up while working with animation nodes in Godot are applicable to many other game development scenarios, making this a versatile tool in your toolkit. So, if you’re passionate about creating smooth, natural motions in your game, this tutorial will guide you step by step on how to harness the power of `AnimationNodeBlend3`.

CTA Small Image

Creating a Simple Blend Tree

Before we delve into `AnimationNodeBlend3`, let’s start by setting up a basic blend tree. This will be the groundwork for incorporating our blend node.

1. Creating an AnimationTree:
The `AnimationTree` node allows us to manage complex animations. To add one, simply:

var anim_tree =

2. Assigning an AnimationPlayer:
The `AnimationTree` requires an `AnimationPlayer` to function. Here’s how you link the two:

anim_tree.animation_player = $AnimationPlayer

3. Enabling the AnimationTree:
To make sure the `AnimationTree` processes, we need to set its ‘active’ property to true: = true

Configuring AnimationNodeBlend3 within the Blend Tree

Once you have an `AnimationTree` set up, you can begin to work with `AnimationNodeBlend3`.

1. Adding an AnimationNodeBlendTree:
To incorporate a blend tree into your `AnimationTree`, you can do the following:

var blend_tree =
anim_tree.tree_root = blend_tree

2. Creating an AnimationNodeBlend3 Node:
Now, let’s create an `AnimationNodeBlend3` node and add it to your blend tree:

var blend3_node =
blend_tree.add_node("Blend3", blend3_node)

3. Adding Animations to the Blend Node:
It’s time to add some animations to the blend node. You need at least two animations to blend between:

var anim1 =
anim1.animation = "walk"
blend_tree.add_node("walk", anim1, Vector2(0, -100))

var anim2 =
anim2.animation = "run"
blend_tree.add_node("run", anim2, Vector2(0, 100))

blend_tree.connect_node("walk", "", "Blend3", 1)
blend_tree.connect_node("run", "", "Blend3", 2)

4. Setting Up Blending:
With the animations connected, you can now control the blend amount programmatically through the `blend_position` property:

// Blend halfway between 'walk' and 'run'.
blend3_node.blend_position = 0.5

By setting `blend_position`, you can smoothly interpolate between your animations, which, in our example, are “walk” and “run.” This example serves as the foundation for more intricate blending operations we will explore next. Keep in mind that setting up the appropriate animations is key for a successful blend, so make sure your `AnimationPlayer` is properly configured with suitable animations for blending.Continuing from where we left off, let’s delve deeper into working with `AnimationNodeBlend3` and explore various functionalities to enhance our blend trees for more dynamic character movement.

Manipulating the Blend Space Programmatically:
The real power of animation blending comes from adjusting the blend space during runtime. This allows for dynamic transitions that reflect the character’s state in-game:

// Set blend to favor 'walk' animation.
blend3_node.blend_position = -0.7

// Set blend to favor 'run' animation.
blend3_node.blend_position = 0.7

Responding to User Input:
Blending can be directly tied to user input. Below is an example of how you might adjust the blend depending on whether the player is walking or running:

func _process(delta):
    if Input.is_action_pressed("ui_run"):
        blend3_node.blind_position = lerp(blend3_node.blend_position, 1.0, 0.1)
        blend3_node.blind_position = lerp(blend3_node.blend_position, -1.0, 0.1)

Connecting to Signals:
`AnimationNodeBlend3` also emits signals when blending. You can connect these signals to customize responses to certain blending points:

blend3_node.connect("changed", self, "_on_Blend3_changed")
func _on_Blend3_changed():
    print("Blend position changed!")

Blending with a Filter:
Sometimes, you may want to blend animations but limit which tracks are affected. You can set up a filter to achieve this:

blend3_node.set_filter_path("Character/Skeleton:transform/legs", true)

This can filter out specific node paths from the blend, letting you isolate certain body parts, like the legs in the above example.

Using AnimationNodeBlend3 in combination with other nodes:
Your blend tree can grow more complex by adding more nodes. Consider using a `AnimationNodeBlend2` to combine another animation into the mix:

var blend2_node =
var idle_anim =
idle_anim.animation = "idle"

blend_tree.add_node("idle", idle_anim, Vector2(-100, 0))
blend_tree.add_node("Blend2", blend2_node, Vector2(200,0))

blend_tree.connect_node("idle", "", "Blend2", 1)
blend_tree.connect_node("Blend3", "", "Blend2", 2)

// Now you've got a setup with idle, walk and run blending!

Finally, you need to ensure that your blend tree’s layout reflects the structure you’ve set programmatically. In the Godot editor, under the ‘AnimationTree’, make sure your nodes are connected correctly in the visual editor. With these code examples and techniques, you are now equipped to create sophisticated animation blends that will breathe life into your game characters. Remember, great animation is a dance between art and code—by mastering both; you’re on your way to creating truly immersive game experiences.Building upon the foundations we’ve set, let’s explore some advanced configurations for `AnimationNodeBlend3`.

Animating the Blend:
Beyond responding to user input, you can animate the blend position over time for predetermined animations:

// Increase blend position over time to shift from 'walk' to 'run'.
func _process(delta):
    blend3_node.blind_position += delta * 0.5
    blend3_node.blind_position = clamp(blend3_node.blend_position, -1.0, 1.0)

Using Timers for Blending:
For timed transitions, such as a character powering up or winding down, you could use a timer:

var timer =
timer.wait_time = 1.0
timer.one_shot = true
timer.connect("timeout", self, "_on_timer_timeout")

func _on_timer_timeout():
    blend3_node.blind_position = 1.0 // Fully blend to 'run'

timer.start() // Begin the timed blend

Adjusting Blend Based on Velocity:
For more realistic transitions, you might blend animations based on the character’s velocity:

var velocity = Vector2.ZERO

func _process(delta):
    velocity = get_velocity() // Replace with your actual velocity obtaining function
    var blend_amount = map(velocity.length(), 0, max_speed, -1, 1)
    blend3_node.blind_position = blend_amount

Synchronizing Animations:
When blending, you might want to keep the animations in sync, so transitions don’t reset animation timings:

func _ready():
    blend_tree.connect("time_changed", self, "_on_time_changed")

func _on_time_changed(animation_name, time):
    anim1.set_animation_time(animation_name, time)
    anim2.set_animation_time(animation_name, time)

Script-Driven Animation Changes:
Sometimes you want to change the animation based on the logic in a script, for example during a cutscene:

func play_cinematic_animation():
    anim1.animation = "hero_talk"
    anim2.animation = "hero_listen"
    blend3_node.blind_position = 0.0 // Fully blend to 'hero_talk'

These examples illustrate how you can manipulate animation blending through code to achieve a variety of gameplay mechanics and visual styles. It underscores the versatility of the `AnimationNodeBlend3` allowing for an impressive array of techniques to visually enrich your game. From syncing animations to adjusting blend positions over time or in response to events, these scripting methods offer a taste of the creative control that `AnimationNodeBlend3` places at your fingertips. Keep experimenting with these functionalities to discover new and innovative ways to bring your game’s animations to life!

Where to Go Next in Your Game Development Journey

Congratulations on taking a significant step in learning about `AnimationNodeBlend3` in Godot 4! This knowledge sets a fantastic foundation for creating more dynamic, responsive gameplay experiences. But don’t stop here—there’s a whole world of game development waiting for you!

If you’re looking to dive deeper and expand your skill set in Godot 4, our Godot Game Development Mini-Degree is the perfect next step. This collection of courses walks you through building cross-platform games from the ground up. You’ll gain hands-on experience with a wide range of development topics and become well-versed in both the theory and practice of game creation.

For those who yearn to explore an even broader selection of topics, we invite you to browse our full catalog of Godot courses. At Zenva, we provide carefully crafted content suitable for all levels—from beginners just starting their coding journey to seasoned professionals enhancing their abilities. Embark on this exciting path with us, further your education, and bring your game development dreams to life!


Animating characters and objects is a delightful yet complex part of game development, which is why mastering tools such as Godot’s `AnimationNodeBlend3` is invaluable. Embrace the knowledge you’ve gained, experiment with it, and remember that each blend brings your game closer to the seamless, engaging experience you envision. Your journey into game creation continues with each step you take, be it a simple line of code or the intricate dance of motions in an animated scene.

Don’t let the learning stop here; join us at Zenva where our Godot Game Development Mini-Degree awaits to take you through the paces of crafting interactive experiences that captivate players. By furthering your education with us, the games of tomorrow will be born from the skills you develop today. Let’s continue creating, learning, and breaking boundaries together!

Python Blog Image

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