AnimatedSprite2D in Godot – Complete Guide

Animated sprites give life to our game characters and elements, transforming static images into vibrant characters that move and interact with the world we create. Whether evoking the mood of a bustling city street or the tense atmosphere of a boss battle, animation is a cornerstone of game development. Today, we’ll delve into the foundations of using the AnimatedSprite2D class in Godot 4 and explore how this powerful feature can add dynamism to your 2D games.

What Is AnimatedSprite2D?

AnimatedSprite2D is a node in Godot 4 specifically designed for 2D animation. It acts much like the regular Sprite2D node, but with a significant twist: it allows for multiple textures to act as frames of an animation. This functionality is essential for creating character animations, UI effects, or any dynamic visual elements within your games.

What Is It Used For?

With AnimatedSprite2D, you can create a variety of animations using a series of images. Whether your character is running, jumping, attacking, or idling, each action can be vividly portrayed through an animation sequence. This node enables you to harness the full potential of visual storytelling in your game.

Why Should I Learn About It?

Understanding the AnimatedSprite2D class opens up a whole new realm of possibilities in game design. By learning about this feature, you can:

– Create more engaging and interactive gameplay experiences.
– Bring your game world and its inhabitants to life with smooth, compelling animations.
– Enhance the visual appeal of your game, making it stand out to players.

Mastering animation in Godot 4 isn’t just about making objects move; it’s about breathing life into your digital creations and captivating your audience, no matter where they are on their gaming journey.

CTA Small Image

Creating an AnimatedSprite2D Node

Firstly, we need to add an AnimatedSprite2D node to our scene. We can do this by selecting the node we want to attach it to, clicking the “Add Child Node” button, and choosing AnimatedSprite2D from the list.

var animated_sprite =

Once the AnimatedSprite2D node is in our scene, we can proceed to configure its properties. In the Inspector, you can assign a SpriteFrames resource, which holds the animation frames.

Setting Up SpriteFrames

A SpriteFrames resource contains the animations for an AnimatedSprite2D node. Here, you define the various animations by naming them and specifying their frames.

Create a new SpriteFrames resource in the Inspector.

var sprite_frames =
animated_sprite.sprite_frames = sprite_frames

Now, let’s add frames to an animation. For this example, suppose we have a set of frames named walk0.png to walk3.png for a walking animation.

var frames = []
for i in range(4):
    var frame = preload("res://path_to_frames/walk" + str(i) + ".png")
sprite_frames.set_animation_frames("walk", frames)

After setting up the frames, we can start the animation using:"walk")

This code snippet will start the walk animation.

Animating with Code

Godot allows us to handle animations directly through GDScript. This is powerful, as it enables dynamic control based on game logic.

Here’s an example of controlling animations in code:

# Suppose this function is called whenever the player starts moving
func start_walking():"walk")

# And this one when the player stops
func stop_walking():
    animated_sprite.frame = 0

You can also check if an animation is currently playing:

if animated_sprite.is_playing():
    print("Animation is playing!")

Handling Animation Loops and Signals

Animations can loop endlessly, or play once. To make an animation loop:

sprite_frames.set_animation_loop("walk", true)

If you want to execute code after an animation has finished, you can use the `animation_finished` signal.

Connect the signal in code:

animated_sprite.connect("animation_finished", self, "_on_AnimatedSprite2D_animation_finished")

func _on_AnimatedSprite2D_animation_finished():
    print("Animation has finished!")

Or connect the signal via the Godot Editor by going to the Node tab, selecting the signal, and attaching it to a function.

Using signals is an excellent way to coordinate events with the end of an animation, like transitioning to a different state or triggering game logic.

# Set up an idle animation just as we did with the walk animation
var idle_frames = []
for i in range(4):
    var frame = preload("res://path_to_frames/idle" + str(i) + ".png")
sprite_frames.set_animation_frames("idle", idle_frames)

# Here we have a function that could be called when a character is idle
func start_idle():"idle")

To switch between animations based on in-game events, such as the player character transitioning from idle to walking:

# A function to change the character's state based on player input
func update_character_state(is_moving):
    if is_moving:

Animations may also need to change speed dynamically. Adjusting the playback speed of an animation can help you fine-tune your character’s movements.

# Speed up the walking animation
sprite_frames.set_animation_speed("walk", 2.0)  # Double the speed

# Slow down the walking animation
sprite_frames.set_animation_speed("walk", 0.5)  # Half the speed

Sometimes, you need to react immediately when a specific frame is reached. For example, to create a footstep sound at a certain point in a walk cycle:

animated_sprite.connect("frame_changed", self, "_on_AnimatedSprite2D_frame_changed")

func _on_AnimatedSprite2D_frame_changed():
    if animated_sprite.animation == "walk" and animated_sprite.frame == 2:
        # Play footstep sound

Animation blending can make transitions between animations smoother. Although AnimatedSprite2D does not support blending directly, you can simulate it by carefully controlling the visibility of two AnimatedSprite2D nodes.

# Assuming we have two AnimatedSprite2D nodes, 'sprite_a' and 'sprite_b',
# this code smoothly transitions from 'sprite_a' playing "idle" to 'sprite_b' playing "walk""idle")"walk")
sprite_b.modulate = Color(1, 1, 1, 0)  # Start sprite_b as fully transparent

# Over the duration, fade out sprite_a and fade in sprite_b
for t in range(duration):
    var alpha = t / duration
    sprite_a.modulate = Color(1, 1, 1, 1 - alpha)
    sprite_b.modulate = Color(1, 1, 1, alpha)
    yield(get_tree().create_timer(0.05), "timeout")  # Delay for illustration 

# At the end, ensure sprite_a is hidden and sprite_b is fully visible
sprite_a.visible = false
sprite_b.modulate = Color(1, 1, 1, 1)

Learning how to manage these animation states, speeds, and transitions is crucial as they can greatly increase the professionalism and polish of your game. With practice, you’ll find that the AnimatedSprite2D class becomes a powerful tool in your Godot development toolbox.Let’s dive further into advanced techniques and tips for optimizing the use of `AnimatedSprite2D` in Godot 4.

Switching between animations based on player interaction or game events is a common need in game development. Here’s how we might handle a basic attack animation when the player hits a control button:

# This might be connected to an input event for attacking
func on_attack_pressed():
    if animated_sprite.animation != "attack":"attack")

To ensure that our character doesn’t start another attack animation before the current one has finished, we can use a boolean flag:

var is_attacking = false

func on_attack_pressed():
    if !is_attacking:"attack")
        is_attacking = true

func _on_AnimatedSprite2D_animation_finished():
    if animated_sprite.animation == "attack":
        is_attacking = false

Synchronized animations are essential when you have multiple characters or objects that should animate in tandem. For instance, if we want two characters to jump at the same time, we can achieve it by:

# A function that causes two characters to jump
func simultaneous_jump(character_one, character_two):"jump")"jump")

Sprite flipping is a convenient feature that is often used to change the direction a character is facing without having to create additional animations:

# Assuming the default facing direction is right
# This flips the sprite to face left
animated_sprite.flip_h = true

# To flip the sprite back to face right
animated_sprite.flip_h = false

Mirroring animations can be useful in case you need a reverse direction but want to reuse the same frames:

sprite_frames.set_animation_speed("walk", 1.0)  # Original speed
sprite_frames.set_animation_mirror("walk", true)  # Mirror frames

Sometimes you may want to pause an animation on a specific frame, which could be part of a cutscene or when the game is paused. Here’s how you can do it:

animated_sprite.stop()  # Stop the current animation
animated_sprite.frame = 3  # Set to the desired frame

While the `AnimatedSprite2D` node provides robust control over 2D animations, efficient use of these features leads to smoother gameplay and better player experiences. Remember, good animation can make your game feel responsive and satisfying to play. We encourage you to experiment with these examples and adapt them to your needs, expanding upon the capabilities of `AnimatedSprite2D` for your specific game projects.

Continue Your Game Development Journey with Zenva

Now that you’ve gotten a taste of animating 2D sprites in Godot 4, the path forward is both thrilling and rewarding. Your next steps involve deepening your understanding, refining your skills, and starting on ambitious projects that reflect your creativity and passion for game development.

We, at Zenva, offer a comprehensive learning pathway for those eager to master game creation with Godot. Our Godot Game Development Mini-Degree is tailored to guide you from the basics towards building complete games. Whether you’re beginning your journey or looking to level up your development skills, the mini-degree includes topics such as game mechanics, asset creation, gameplay controls, combat systems, and AI, all taught through interactive lessons.

If you’re looking to explore a broader variety of subjects within this versatile engine, our extensive collection of Godot courses will surely satisfy your educational needs. These courses are step-by-step, flexible, and designed to fit your schedule. You’ll not only gain the knowledge but also earn certificates as a testament to your hard work and achievements.

There’s always more to learn and create – let Zenva be your guide on your journey to becoming a professional game developer. We look forward to supporting you every step of the way!


As your exploration of Godot 4’s animation capabilities comes to an end, remember that every professional journey is a mosaic of small, dedicated steps towards mastery. The world of game development is as vast as your imagination, and the skills you’ve started to build with `AnimatedSprite2D` are the building blocks to bringing your wildest game ideas to life. Strive to push the boundaries of what you can create, refine your craft with each project, and remain a lifelong learner.

Dive into the vibrant community of game developers, and when you’re ready to take the next step, our Godot Game Development Mini-Degree awaits to open new horizons in your game development journey. At Zenva, we are committed to fueling your passion with knowledge and empowering you to create truly remarkable gaming experiences. Keep coding, keep creating, and let’s shape the future of gaming together!

Python Blog Image

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