IntervalTweener in Godot – Complete Guide

When venturing into the exciting world of game development, animation control can be a crucial aspect to master for creating compelling gameplay experiences. Among the tools available to Godot 4 users is the intriguing IntervalTweener class, which allows developers to implement pauses or timing delays in their animations with ease. Understanding how to effectively use the IntervalTweener can elevate your game’s feel and polish, providing those precisely timed moments that greatly impact the player’s experience.

What Is IntervalTweener?

What Is IntervalTweener?

IntervalTweener is a class within the extensive Godot 4 engine that is designed to pause or create delays within a series of tweens. Tweens, short for ‘in-betweens’, are animation tools used to interpolate the values of various properties over time, creating smooth transitions for game objects. IntervalTweener slots into this process, allowing developers to sequence these transitions with specified intervals of non-action.

What Is IntervalTweener Used For?

In the realm of game design, timing can be as important as the animations themselves. IntervalTweener serves as the guide that paces our visual transitions. Whether it’s delaying the start of an explosion to heighten anticipation or pausing the victory dance of a character to coincide with the climax of the background music, IntervalTweener manages these moments seamlessly within a tweening sequence.

Why Should I Learn to Use IntervalTweener?

Gaining proficiency with the IntervalTweener is about so much more than learning a single class; it’s about mastering the art of timing in animations. Knowing how to implement these intervals effectively can turn a basic transition into an experience that feels elegant and thoughtfully crafted. It’s a subtle tool with the potential for a mighty impact on the player’s engagement and enjoyment, making it an essential skill in your game development arsenal.

CTA Small Image

Setting Up IntervalTweener in Godot 4

The first step in utilizing IntervalTweener is to set it up in your Godot 4 environment. Begin by creating a new script and prepare a basic setup where you’ll attach IntervalTweener to the node you wish to animate:

extends Node

var intervaller

func _ready():
    intervaller =

This code snippet creates an IntervalTweener instance and adds it as a child to the current node, ensuring that it is part of the scene tree and can function correctly.

Creating Delays Between Tweens

To demonstrate how IntervalTweener can be used to create delays between animations, consider a scenario where an object needs to move to a point, pause, and then scale up after the pause:

func animate_movement_and_scaling():
    intervaller.tween_position(node, from_pos, to_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    intervaller.wait(0.5) # Wait for 0.5 seconds
    intervaller.tween_property(node, "scale", from_scale, to_scale, 1.0, Tween.TRANS_QUAD, Tween.EASE_IN)

In this example, we are moving ‘node’ from ‘from_pos’ to ‘to_pos’ over one second. After moving, the script commands IntervalTweener to wait for half a second before starting the next animation, which scales the node from ‘from_scale’ to ‘to_scale’.

Sequencing Multiple Animations

IntervalTweener becomes truly powerful when you use it to sequence multiple animations. Below is an example where we create a sequence of position and color changes:

func animate_position_and_color():
    intervaller.tween_property(node, "position", start_pos, mid_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    intervaller.tween_property(node, "modulate", color_start, color_mid, 1.5, Tween.TRANS_SINE, Tween.EASE_IN_OUT)
    intervaller.tween_property(node, "position", mid_pos, end_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    intervaller.tween_property(node, "modulate", color_mid, color_end, 1.5, Tween.TRANS_SINE, Tween.EASE_IN_OUT)

This snippet showcases a node changing position from ‘start_pos’ to ‘mid_pos’, while its color also changes from ‘color_start’ to ‘color_mid’. After waiting for a second, the node moves to ‘end_pos’ and its color shifts to ‘color_end’.

Controlling Repeat and Reverse Animations

At times, you may want your animations to repeat or even play in reverse. Here’s how you can control these aspects using IntervalTweener:

func repeat_reverse_animation():
    intervaller.tween_property(node, "position", start_pos, end_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    intervaller.tween_property(node, "position", end_pos, start_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT, true) # true for reverse
    intervaller.set_repeat(2) # Repeat the entire sequence twice

This code moves the node from ‘start_pos’ to ‘end_pos’, waits for half a second, then reverses the animation, moving the node back to ‘start_pos’. The sequence is set to repeat twice.

Utilizing these basic IntervalTweener functionalities in Godot 4, you can begin to build more complex and dynamic animations that engage players and enhance the overall gaming experience. By effectively sequencing and timing animations, the feel and flow of gameplay can be drastically improved, taking your project to the next level.

Advanced IntervalTweener Techniques

As we delve deeper into the capabilities of IntervalTweener, let’s explore some advanced techniques. By leveraging additional features of the IntervalTweener class, you can bring even more life and complexity to your animations in Godot 4.

One of the powerful features of IntervalTweener is the ability to queue up multiple tweens to be executed sequentially with varying delays. You can further control these animations by using callbacks for even greater precision and interaction:

func queued_animation_sequence():
    intervaller.tween_property(node, "position", start_pos, mid_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    .tween_property(node, "modulate", color_start, color_mid, 1.5, Tween.TRANS_SINE, Tween.EASE_IN_OUT)
    .tween_property(node, "position", mid_pos, end_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    .tween_property(node, "modulate", color_mid, color_end, 1.5, Tween.TRANS_SINE, Tween.EASE_IN_OUT)

This chained setup simplifies code readability and compactly organizes animation sequences. Additionally, callbacks can be inserted at strategic points to allow for interaction during the sequence. For example, adding sound effects or triggering other events can be timed perfectly with animations:

func queued_animation_with_callbacks():
    intervaller.tween_property(node, "position", start_pos, mid_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    .call_method(self, "_play_sound_effect", "whoosh")
    .tween_property(node, "modulate", color_start, color_mid, 1.5, Tween.TRANS_SINE, Tween.EASE_IN_OUT)
    .call_method(self, "_trigger_event", "power_up")
    .tween_property(node, "position", mid_pos, end_pos, 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)

func _play_sound_effect(sound_name):
    # Play a sound effect based on its name
    # ...

func _trigger_event(event_name):
    # Trigger an event based on its name
    # ...

By tactically placing `call_method` between tweens or waits, you can blend actions such as method calls into your animation sequence, maintaining a smooth flow and enhancing the user experience.

Looping animations can create dynamic background elements or continuous character actions. Here’s how you’d create a looping animation that animates infinitely:

func infinite_loop_animation():
    intervaller.tween_property(node, "rotation_degrees", 0, 360, 4.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)

The `.set_loops(Tween.LOOP_INF)` command tells IntervalTweener to loop the animation indefinitely, perfect for spinning wheels or rotating backgrounds.

Furthermore, easing and transitioning can be controlled per tween to create a more compelling sequence:

func complex_ease_animation():
    intervaller.tween_property(node, "position", start_pos, mid_pos, 1.0, Tween.TRANS_BOUNCE, Tween.EASE_OUT)
    .tween_property(node, "position", mid_pos, end_pos, 2.0, Tween.TRANS_ELASTIC, Tween.EASE_IN_OUT)

Here, `Tween.TRANS_BOUNCE` and `Tween.TRANS_ELASTIC` are used to add bounce and elasticity respectively to the motion of `node`, creating a more dynamic movement.

Finally, for cases where greater control is needed over tween initialization or completion, signals can be utilized:

func setup_with_signals():
    intervaller.connect("tween_begin", self, "_on_tween_begin")
    intervaller.connect("tween_complete", self, "_on_tween_complete")
    intervaller.tween_property(node, "position", start_pos, end_pos, 1.0, Tween.TRANS_QUINT, Tween.EASE_IN_OUT)

func _on_tween_begin(tween, object):
    # Handle the beginning of a tween 
    # ...

func _on_tween_complete(tween, object):
    # Perform actions after a tween completes
    # ...

By connecting signals `tween_begin` and `tween_complete` to respective methods, we can execute code at the start or end of each tween, giving us moment-to-moment feedback about the animation state, which is useful for synchronization with other game events.

Overall, IntervalTweener can serve as a sophisticated tool in the Godot 4 animation toolkit. Its ability to manage timing and order of operations enables developers to create complex sequences and responsive animations which make games stand out. We at Zenva encourage you to experiment with these techniques to see how they can best serve the custom needs of your gameplay experience.

Let’s explore some further nuances of using IntervalTweener in Godot 4 which can empower your animations with even more control and fluency.

One common animation is a heartbeat effect, where an object scales up and down to mimic a beating heart. Here’s how you could achieve that:

func heartbeat_animation():
    intervaller.tween_property(node, "scale", Vector2(1, 1), Vector2(1.2, 1.2), 0.3, Tween.TRANS_QUAD, Tween.EASE_IN)
    .tween_property(node, "scale", Vector2(1.2, 1.2), Vector2(1, 1), 0.3, Tween.TRANS_QUAD, Tween.EASE_OUT)
    .wait(0.4) # Pause between beats

For moving an object along a path with pauses at key points, imagine a spotlight moving along a stage:

func spotlight_path_animation():
    intervaller.tween_property(node, "position", points[0], points[1], 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    .wait(1.0) # Pause at a spot
    .tween_property(node, "position", points[1], points[2], 1.0, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    .wait(2.0) # Longer pause for a speech
    .tween_property(node, "position", points[2], points[3], 1.5, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)

Animations can also follow user input, for example, a button that responds to clicks with a bounce effect:

func bounce_button_animation():
    intervaller.tween_property(button_node, "rect_scale", Vector2(1, 1), Vector2(1.1, 1.1), 0.1, Tween.TRANS_QUAD, Tween.EASE_OUT)
    .tween_property(button_node, "rect_scale", Vector2(1.1, 1.1), Vector2(1, 1), 0.1, Tween.TRANS_QUAD, Tween.EASE_IN)

# Connect this to the button's pressed signal
func _on_button_pressed():

If your game involves day-to-night transitions, you’ll want a smooth effect for dimming the light. You can achieve a natural dusk effect using the following code:

func day_to_night_animation():
    intervaller.tween_property(light_node, "color", day_color, dusk_color, 2.0, Tween.TRANS_QUAD, Tween.EASE_IN)
    .wait(0.5) # Small pause as it gets darker
    .tween_property(light_node, "color", dusk_color, night_color, 3.0, Tween.TRANS_QUAD, Tween.EASE_OUT)

Lastly, managing the clean-up process and ensuring that you do not have memory leaks or leftover nodes after finishing an animation is crucial. Here’s how you might end and remove an IntervalTweener when you’re done:

func clear_tween_on_completion():
    intervaller.tween_property(node, "position", start_pos, end_pos, 1.0, Tween.TRANS_SINE, Tween.EASE_IN_OUT)
    intervaller.connect("tween_all_completed", self, "_on_tween_all_completed")

func _on_tween_all_completed():
    intervaller.queue_free() # Removes the IntervalTweener after all animations have completed

In this setup, once all tweens have completed, the `_on_tween_all_completed` function is called, which in turn removes the IntervalTweener node from the scene. This is important for both memory management and node organization within your scene.

Through these examples, you can see that IntervalTweener is versatile and can be used for a plethora of animations within your Godot 4 projects. We at Zenva always strive to provide robust examples and educational content that empower you, as developers, to realize your creative visions with efficiency and finesse. Harnessing the power of the IntervalTweener class, you can add impressive polish to your games and ensure that they stand out with professional-grade animations.

Continuing Your Game Development Journey

You’ve made impressive strides by exploring the IntervalTweener class in Godot 4, but this is just the beginning of your development journey. If you want to keep growing your skills and building more intricate and engaging games, Zenva offers a path to take your creations to the next level.

Our Godot Game Development Mini-Degree is tailored to guide you from the fundamentals of Godot to building complete games. You’ll learn how to use 2D and 3D assets, create advanced gameplay mechanics, and script in GDScript. The courses offer a mix of foundational knowledge and project-based learning, making it perfect for both beginners and experienced developers.

For a broader palette of learning resources, check out our comprehensive selection of Godot courses. Zenva’s courses are designed to help you develop a strong portfolio, gain in-demand game development skills, and open up doors to new opportunities in the industry. Continue your learning adventure with us, and turn your game development dreams into tangible reality.


In wrapping up, mastering the IntervalTweener in Godot 4 can truly set your game animations apart, providing the polish, timing, and flow that are the hallmarks of a professional developer. Whether you’re animating a character, controlling the environment, or creating responsive UI elements, the skills you cultivate now will serve as the building blocks for immersive and interactive games that captivate players.

Remember, what you’ve learned here is a glimpse of what’s possible when you unlock the full potential of game development with Godot. We encourage you to dive deeper with Zenva’s Godot Game Development Mini-Degree, where each course is a step forward in your journey to becoming a proficient game developer. Level up your skills with us, and take pride in crafting the next standout title in the gaming world!

Python Blog Image

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