AnimationNodeAdd2 in Godot – Complete Guide

Welcome to our tutorial on the AnimationNodeAdd2 class in Godot 4.0. If you’re looking to inject some dynamic movement into your games, mastering animation blending with Godot’s powerful animation system is a key skill. This tutorial will guide you through the nuances of additive animation blending and how to use the AnimationNodeAdd2 class to create more realistic and complex animations for your game characters and objects.

What makes animation blending essential, you might wonder? It allows for smooth transitions and combinations of animations, which can drastically increase the perceived quality of your game. By learning the capabilities of AnimationNodeAdd2, you’ll be able to blend animations additively, creating a seamless and natural experience.

What is AnimationNodeAdd2?

The AnimationNodeAdd2 class is a resource designed for use within Godot’s AnimationNodeBlendTree. It allows developers to blend two animations together additively based on a set “amount” value. The concept of additive animation is crucial for creating believable motion, layering one set of movements upon another, for results that can convey intricate actions and emotions.

What is it for?

The purpose of using AnimationNodeAdd2 goes beyond mere aesthetic improvements. It enables the creation of complex animations where base movements can be accentuated or reversed by overlaying additional animations. Whether you’re looking to amplify a character’s run cycle with a heavy breathing animation or want to invert a cascading movement to simulate a recoil, AnimationNodeAdd2 provides the tools for such intricate manipulation.

Why Should I Learn It?

Understanding and utilizing AnimationNodeAdd2 in your projects can vastly improve the quality and responsiveness of your animations. Games often require dynamic reactions and environment interactions, and mastering this class will enable you to create animations that react fluidly to gameplay. It’s not just about bringing characters to life; it’s about creating an interactive world that responds and evolves with the player’s actions. Whether you’re beginning your game development journey or looking to refine your skills, learning about AnimationNodeAdd2 is a step forward in crafting immersive gaming experiences.

CTA Small Image

Creating an AnimationNodeBlendTree with AnimationNodeAdd2

Before we delve into working with AnimationNodeAdd2, we need to set up an AnimationNodeBlendTree in our Godot project. Here’s how to start off by creating a simple blend tree within an AnimationTree node:

var blend_tree =
var animation_tree =
animation_tree.tree_root = blend_tree

Now that we have our blend tree, we can begin adding AnimationNodeAdd2 to blend two animations together:

var add2_node =
blend_tree.add_node(add2_node, "Add2Node")

Connecting Animations to AnimationNodeAdd2

Let’s say we have two animations: a walk cycle (‘walk’) and a breathing cycle (‘breathe’). We’ll add them to our blend tree and then connect them to the AnimationNodeAdd2 node:

var walk_animation = blend_tree.get("parameters/Animation1")
var breathe_animation = blend_tree.get("parameters/Animation2")

blend_tree.connect_node(walk_animation, "", add2_node, "input1")
blend_tree.connect_node(breathe_animation, "", add2_node, "input2")

This sets the walk cycle as the base animation and the breathing cycle as the animation we’ll add on top of it.

Adjusting the Amount Value for Additive Blending

We control the blend amount through the `amount` parameter of the AnimationNodeAdd2. It determines how much of the second animation will blend with the first. Here is how you can dynamically update the blend amount in code:

animation_tree["parameters/Add2Node/amount"] = 0.5  # 50% blend

This would result in an equal blend of both the walk and breathe animations. If we need to animate the blend amount over time or respond to user input, Godot’s tweening system or code logic can be utilized to update this value.

Playing the Blended Animation

Finally, to see our blended animation in action, we need to activate the AnimationTree and start the blended animation using our AnimationNodeAdd2: = true"Add2Node")

That’s it for the basic setup! The character should now exhibit a walk animation that’s subtly enhanced by the breathing animation, providing a more nuanced and lively appearance.In our ongoing exploration of the AnimationNodeAdd2 class in Godot, it’s time to dive deeper into the possibilities it opens up. A thorough understanding of how to manipulate the blend amounts and respond to in-game events can bring your character to life as they interact with the game world. Let’s explore further applications and how to implement them through code.

Dynamic Blending Based on In-Game Events

Imagine your character’s breathing becomes more pronounced when they are running as opposed to walking. You would want to increase the blend amount of the ‘breathe’ animation relative to the character’s speed:

var current_speed = character.get_velocity().length()

# Assuming the max_speed is set according to your character's maximum velocity
var blend_ratio = min(current_speed / max_speed, 1.0)
animation_tree["parameters/Add2Node/amount"] = blend_ratio

In this example, as the character’s speed approaches the max_speed, the blend ratio approaches 1, which means the breathing animation becomes more visible.

Layering Multiple Additive Animations

You can layer multiple AnimationNodeAdd2 instances to create complex blends. For example, if you want to add a third animation, say ‘jump’, on top of your walk and breathe animations, you would first create another add2 node:

var jump_add2_node =
blend_tree.add_node(jump_add2_node, "JumpAdd2Node")

Then you’d connect your previous add2 node and the new jump animation to the new add2 node:

blend_tree.connect_node("Add2Node", "", "JumpAdd2Node", "input1")
blend_tree.connect_node(jump_animation, "", "JumpAdd2Node", "input2")

Now, your blend tree is ready to handle a third animation layer. Suppose we want to display the jump animation every time our character jumps, we’d adjust the `amount` again based on whether the character is airborne:

var is_jumping = character.is_in_air()

animation_tree["parameters/JumpAdd2Node/amount"] = is_jumping ? 1.0 : 0.0

Fading Between Additive Animations

Sometimes, a sharp transition between animations isn’t ideal. Smooth fades are essential for polished gameplay:

func _process(delta):
    var target_amount = character.is_in_air() ? 1.0 : 0.0
    var current_amount = animation_tree["parameters/JumpAdd2Node/amount"]
    var new_amount = lerp(current_amount, target_amount, delta * fade_speed)

    animation_tree["parameters/JumpAdd2Node/amount"] = new_amount

Here, `fade_speed` is a variable that defines how quickly you want the transition to happen; `delta` is the frame time.

Responding to Player Input

Player controls can also dictate animation blends. To have your character dodge when the player presses a specific button:

if Input.is_action_just_pressed("ui_dodge"):
    animation_tree.set("parameters/DodgeAdd2Node/amount", 1.0)
    yield(get_tree().create_timer(dodge_animation_length), "timeout")
    animation_tree.set("parameters/DodgeAdd2Node/amount", 0.0)

Here, ‘DodgeAdd2Node’ is another instance of an AnimationNodeAdd2 dedicated to the dodge animation, and `dodge_animation_length` is the duration of the dodge.

Modulating Additive Animations with Code

Complex character interactions, like reacting to being hit, can be managed by changing the blend amount based on the intensity of the hit:

func apply_damage(hit_strength: float):
    var impact_amount = clamp(hit_strength / max_hit_strength, 0.0, 1.0)
    animation_tree.set("parameters/HitReactionAdd2Node/amount", impact_amount)
    # Reset amount after the hit reaction plays
    yield(get_tree().create_timer(hit_reaction_length), "timeout")
    animation_tree.set("parameters/HitReactionAdd2Node/amount", 0.0)

Each of these examples represent just a slice of the potential applications for the AnimationNodeAdd2 class in creating rich, dynamic character animations that respond to environment and player input. With Godot 4.0’s robust animation systems, your creativity is the limit. We at Zenva encourage you to experiment with these building blocks to craft fluid and reactive motions that will captivate your players.Animation blending can also be used to reflect the character’s health status, emotion, or fatigue. Let’s look at how to implement a system where a character’s animation changes as their health declines:

func update_health_animation(health_percentage: float):
    var health_blend_amount = 1.0 - health_percentage
    animation_tree["parameters/HealthStateAdd2Node/amount"] = health_blend_amount

In this scenario, ‘HealthStateAdd2Node’ is designed to overlay an injured behavior on the character as their health decreases.

Creating reactions to environmental factors, such as wind or water resistance, can also add another layer of realism to your game. Suppose your character has different animations when walking against strong winds or moving through water:

func update_environment_animation(is_in_water: bool, wind_strength: float):
    var water_amount = is_in_water ? 1.0 : 0.0
    var wind_amount = clamp(wind_strength / max_wind_strength, 0.0, 1.0)

    animation_tree["parameters/WaterResistanceAdd2Node/amount"] = water_amount
    animation_tree["parameters/WindResistanceAdd2Node/amount"] = wind_amount

Character interactions with objects, picking up items, or using tools can also benefit from additive animations. Here’s a simple way to overlay a ‘carry’ animation when the character picks up an object, then revert back once the object is set down:

func on_pick_up_item():
    animation_tree["parameters/CarryItemAdd2Node/amount"] = 1.0
func on_set_down_item():
    animation_tree["parameters/CarryItemAdd2Node/amount"] = 0.0

Furthermore, your character might have special abilities or spells that need to be represented visually. Here’s how you might add a ‘magic casting’ additive animation when the character uses a spell:

func cast_spell():
    animation_tree["parameters/CastSpellAdd2Node/amount"] = 1.0
    yield(get_tree().create_timer(spell_cast_time), "timeout")
    animation_tree["parameters/CastSpellAdd2Node/amount"] = 0.0

Customization of characters through different stances or moods can also be handled through additive blending. If your character needs to switch between a defensive and aggressive stance:

func update_stance(defensive: bool):
    animation_tree["parameters/StanceAdd2Node/amount"] = defensive ? 1.0 : -1.0

In the rare case that you need to remove an AnimationNodeAdd2 from your blend tree perhaps as part of a dynamic system which reacts to the player’s choices or game events, you would do so as follows:


It’s important to handle such removals (or any dynamic structure changes) with caution, ensuring that no other code attempts to access the removed node afterwards.

These examples illustrate the breadth and depth of animation blending through the AnimationNodeAdd2. We at Zenva understand that well-crafted animations can breathe life into a game, enhancing not just the visual flair but the very connection between players and the game. Embrace the power of Godot 4.0’s animation system to enrich your game’s interactive storytelling and player immersion.

Continuing Your Learning Journey in Godot

If you’ve enjoyed taking your first steps into the world of animation blending with the AnimationNodeAdd2 class in Godot 4.0, your journey is just beginning. Animation is a vast landscape and mastering it is a quest that can provide your games with a soul and a heartbeat, captivating your players with every frame.

We at Zenva encourage you to continue honing your skills and expanding your knowledge. Our comprehensive Godot Game Development Mini-Degree offers a trove of resources and courses covering everything from 2D and 3D asset use, to GDScript, control flow, combat systems, and game mechanics across various genres. Designed for both beginners and those wanting to sharpen their developer toolkit, our mini-degree can help you build a robust portfolio of Godot projects while learning at your own pace.

For a broader exploration of what you can learn with us, visit our collection of Godot courses. Whether you’re scripting your first lines of GDScript or architecting intricate game worlds, Zenva is here to support your passion for game development. Keep learning, keep creating, and turn your game ideas into reality.


Delving into the intricacies of Godot 4.0’s AnimationNodeAdd2 is just the tip of the iceberg when it comes to animation blending and game development. Armed with the knowledge and practical examples we’ve explored together, you’re well on your way to creating nuanced, detailed, and reactive animations that will set your games apart. Remember, the depth of your games’ animation can dramatically affect how players connect with your virtual worlds, and mastering tools like AnimationNodeAdd2 opens up a universe of possibilities.

Don’t stop here! Continue to build, experiment, and expand your animation prowess with our Godot Game Development Mini-Degree. Whether you aim to become a Godot guru or a well-rounded game developer, Zenva has the tools and guidance to elevate your skills. Turn your dedication and creativity into captivating experiences, and may your journey in game development be as thrilling as the games you’re destined to create.

Python Blog Image

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