SpriteFrames in Godot – Complete Guide

Sprite animations are an essential component of game development, bringing characters and environments to life. Whether it’s a protagonist’s walk cycle or the flicker of flames in a dungeon, animation plays a pivotal role in storytelling and gameplay. In this tutorial, we’re diving into the world of sprite animations in Godot 4, specifically focusing on the SpriteFrames class – a powerful tool for managing sprite animations for both 2D and 3D games.

Does managing multiple frames and animations for your game characters seem daunting? Fear not! With SpriteFrames, you can create, manipulate, and perfect animations with ease. As we unearth the capabilities of this class, you’ll discover how to take your game’s visuals to the next level.

What is SpriteFrames?

SpriteFrames is a class in Godot 4, where it acts as a library to organize and control sprite animations for AnimatedSprite2D and AnimatedSprite3D nodes. This blueprint centralizes your animation data, such as frame sequences and playback settings, allowing for streamlined animation processes within your game projects.

What is it for?

The primary purpose of the SpriteFrames class is to provide a structured system for managing different animations and their respective frames. It enables game developers to:

– Add and remove animations and frames dynamically
– Set and modify animation properties like speed and looping behavior
– Efficiently control how and when each frame is displayed during an animation cycle

Why Should I Learn It?

Knowing how to use SpriteFrames effectively can:

– Reduce your workload by organizing your animations within Godot’s editor
– Enhance game performance through optimized animation handling
– Give you creative control over the visual timing and sequence of your game’s stories

With these skills, you can ensure your game embodies the smooth and captivating animations that players love. Let’s get started by exploring how to use SpriteFrames to harness the full power of your game’s animated potential.

CTA Small Image

Creating and Managing Animations with SpriteFrames

To begin animating with SpriteFrames, we must first create an AnimatedSprite node. This node will serve as the container for our SpriteFrames resource. Here’s how to create one programmatically:

var animated_sprite = AnimatedSprite.new()
var sprite_frames = SpriteFrames.new()
animated_sprite.frames = sprite_frames

With an AnimatedSprite node and an instance of SpriteFrames in place, we can now start defining animations. The following code demonstrates how to create a new animation called “walk” with specific properties such as loop and speed.

sprite_frames.set_animation_loop("walk", true)
sprite_frames.set_animation_speed("walk", 5)

Now, let’s add frames to our “walk” animation. Assuming you have a series of images for your character’s walking sequence, you can add them as frames using the add_frame() method:

var walk_frames = [preload("res://walk_frame1.png"), preload("res://walk_frame2.png"), preload("res://walk_frame3.png")]
for frame in walk_frames:
    sprite_frames.add_frame("walk", frame)

To play our newly created “walk” animation, we can call the play method on the AnimatedSprite node:


Switching Between Animations

In most games, characters have more than one animation. Here we create an “idle” animations and demonstrate switching between “walk” and “idle.”

Create the “idle” animation with its own frames:

for i in range(1, 4):
    var frame = preload("res://idle_frame" + str(i) + ".png")
    sprite_frames.add_frame("idle", frame)

Switch between “walk” and “idle” depending on the character’s state:

if character_is_moving:

Adjusting Animation Properties

Sometimes, you might want to adjust animations on-the-fly. For example, you may want to change the speed of an animation when a character is running instead of walking.

Change animation speed dynamically:

func set_run_mode(is_running):
    var new_speed = is_running ? 10 : 5  # Faster speed if running
    sprite_frames.set_animation_speed("walk", new_speed)

Or toggle an animation’s looping property when an action is performed only once:

func perform_jump():
    sprite_frames.set_animation_loop("jump", false)

Playing Animations Sequentially

In some cases, we want animations to play in sequence. For example, after a jump, the character might transition into a fall.

Here’s how you can ensure animations play one after another:

func jump_then_fall():
    sprite_frames.set_animation_loop("jump", false) # Ensure jump doesn't loop

    # Signal connection to 'animation_finished' is assumed to be set up
animated_sprite.connect("animation_finished", self, "_on_AnimatedSprite_animation_finished")

func _on_AnimatedSprite_animation_finished():
    if animated_sprite.animation == "jump":

Connecting the “animation_finished” signal from the AnimatedSprite allows us to catch when an animation ends and react accordingly by playing the next desired animation.

Stay tuned as we continue finding out how to harness Godot 4’s SpriteFrames for pixel-perfect animations in the next part of our series!

Using Animation Callbacks

In-game development, it’s often necessary to trigger events at specific points during an animation. For instance, you may want a character to be able to interact with an object, or you might want to play a sound effect precisely when a character’s foot hits the ground. Godot’s SpriteFrames class, in conjunction with signals, makes this a breeze.

Let’s add a function that will be called at a specific frame during an animation:

func _ready():
    animated_sprite.connect("frame_changed", self, "_on_Frame_Changed")

func _on_Frame_Changed():
    if animated_sprite.animation == "walk" and animated_sprite.frame == 2:
        # This could be something like a footstep sound effect

Blending Animations

While not directly a feature of SpriteFrames, in Godot you can blend two different animations to create a smooth transition between them. Imagine a character changing from a walk to a run – you wouldn’t want them to abruptly snap from one to the other. Instead, you could interpolate between the two animations. Although this is more advanced and generally part of a Node2D’s property, it’s good to know when working with animations.

Interpolating between two animations can be achieved as follows:

func interpolate_animations(animation_from, animation_to, weight):
    # Assuming you have a method to blend two animations based on weight
    blend_animation(animation_from, animation_to, weight)

Synchronizing Multiple Animations

Sometimes multiple aspects of a character should be animated simultaneously – like a character’s walk cycle with a bobbing head accessory. You can synchronize these animations by ensuring they play, stop, and loop together.

Synchronize the play state of multiple animations:

func play_synced_animations(animation_name):

func stop_synced_animations():

func set_loop_synced_animations(is_looped):

Flipping and Mirroring Animations

There’s often no need to create a new set of animations for actions in the opposite direction – flipping the sprite horizontally or vertically can achieve the desired effect instantly.

Here’s how you can flip a sprite horizontally when changing direction:

func set_character_direction(is_facing_left):
    animated_sprite.flip_h = is_facing_left

Controlling Animation Playback

Sometimes you’ll need more refined control over your animations, such as pausing or resuming them midway through, or jumping to a particular frame for a starting position.

Pause and resume an animation:

var is_paused = false

func toggle_animation_pause():
    is_paused = !is_paused

Setting the initial frame of an animation:

func set_initial_frame(frame_number):
    animated_sprite.frame = frame_number

Jump to a specific frame within an animation:

func goto_frame(animation_name, frame_number):
    animated_sprite.seek(frame_number / animated_sprite.frames.get_frame_count(animation_name), true)

By incorporating SpriteFrames and these techniques into your Godot 4 projects, you gain solid foundational knowledge and the ability to create dynamic, smooth, and responsive animations. Whether you’re animating a complex character or creating subtle environmental effects, the control SpriteFrames offers is key to bringing your game’s visuals to life. Continue practicing and experimenting with these code examples and you’ll soon be creating rich animations for all players to enjoy.

Customizing Frame Duration

Sometimes, animations require varying the duration of specific frames to emphasize certain actions. For example, if you want a character to pause slightly at the apex of a jump, you can lengthen the frame’s duration.

Here’s how to customize the duration of a specific frame in an animation sequence:

func set_frame_duration(animation_name, frame_number, duration):
    sprite_frames.set_frame_delay(animation_name, frame_number, duration)

Apply it like so:

set_frame_duration("jump", 3, 0.2)  # Lengthen the frame at the peak of the jump

Managing Sprites with AtlasTextures

Using sprite sheets or atlases is a common technique for optimizing your game’s performance. Godot’s AtlasTexture class allows you to manage a large number of sprites stored in a single texture efficiently. Here’s how you create a new AtlasTexture and assign it to a frame:

var atlas = AtlasTexture.new()
atlas.atlas = preload("res://spritesheet.png")
atlas.region = Rect2(0, 0, 32, 32)  # Define the region of the first sprite

sprite_frames.add_frame("idle", atlas)

To define another frame just by setting a new region:

atlas.region = Rect2(32, 0, 32, 32) # Define the region of the second sprite
sprite_frames.add_frame("idle", atlas)

Animating 3D Models with AnimatedSprite3D

Animating 3D models with SpriteFrames can also be accomplished by utilizing the AnimatedSprite3D node. Though 3D animation often involves skeletal rigs and vertex blending, you can animate 3D models using billboards and sprites, like in classic games.

Creating an instance of AnimatedSprite3D is similar:

var animated_sprite_3d = AnimatedSprite3D.new()
animated_sprite_3d.frames = sprite_frames

And you play the animation with the same method:


Exporting SpriteFrames for Team Collaboration

When working with a team, you may need to share sprite animations or synchronize changes. In Godot, you can save your SpriteFrames to a resource file and share it with your team.

Here’s how to save your SpriteFrames as a resource:

var saved_sprite_frames = sprite_frames
ResourceSaver.save("res://saved_sprite_frames.tres", saved_sprite_frames)

And to load the SpriteFrames resource:

var loaded_sprite_frames = preload("res://saved_sprite_frames.tres")
animated_sprite.frames = loaded_sprite_frames

Debugging Animations

To ensure your animations are running as expected, it may become necessary to debug them. You can use the Godot output or debugger to print the current animation and frame.

Printing current animation and frame information can be done during gameplay:

func _process(delta):
    print("Current animation: ", animated_sprite.animation)
    print("Current frame: ", animated_sprite.frame)

Animation Notifications

In addition to the frame_changed signal, the AnimatedSprite nodes have other useful signals for animating sprites, such as signals for when the animation starts or when any looping animation loops.

First, connect to the signals:

animated_sprite.connect("animation_started", self, "_on_AnimatedSprite_animation_started")
animated_sprite.connect("animation_looped", self, "_on_AnimatedSprite_animation_looped")

Then you can add your logic to the connected methods:

func _on_AnimatedSprite_animation_started(anim_name):
    print("Animation started: ", anim_name)

func _on_AnimatedSprite_animation_looped(anim_name):
    print("Animation looped: ", anim_name)

Animations are a vivid aspect of game development, encapsulating the art of movement that makes our digital worlds come alive. As you delve further into Godot 4 and SpriteFrames, remember that with the power of these techniques comes the potential to create truly captivating gameplay experiences. Whether you’re a seasoned developer or just beginning, the world of game animation is at your fingertips, ready to be shaped into something incredible. Keep practicing, keep learning, and let your animations tell the stories you envision.

Continuing Your Journey in Game Development

Your adventure with game development doesn’t have to pause here! Animation is just one facet of creating an engaging game; mastering Godot 4 opens up a universe of possibilities. To keep learning and further enhance your skill set, our Godot Game Development Mini-Degree is the perfect next step. This comprehensive collection will take you deeper into the world of Godot, covering essential topics from 2D and 3D asset implementation to complex gameplay mechanics across various popular game genres.

Whether you’re a beginner just starting out or an experienced developer looking to specialize, our courses provide step-by-step guidance to build your game development portfolio with real Godot projects. What’s more, you’ll be working with Godot’s free and open-source engine, which is a preferred choice for many developers. By mastering the ins and outs of Godot with Zenva, you’re equipping yourself with valuable skills in a field that’s seeing ever-increasing demand.

If you’re eager to dive into more topics and expand your knowledge even further, explore our broader collection of Godot courses here. With our hands-on approach, flexible learning options, and comprehensive content, Zenva is committed to guiding you from your first steps to professional fluency. So why wait? Continue your journey and start creating your own incredible games today.


As your curiosity takes the helm, remember that the art of game development is a journey of continuous learning and creation. Sprite animations are merely the beginning, beckoning you towards a plethora of skills waiting to be mastered in the vibrant Godot engine. Our Godot Game Development Mini-Degree is ready to stand as your guide, your resource, and your companion as you forge your path through the fascinating terrain of game design and development.

This guide has opened a window into the dynamic world of sprite animation with Godot 4, and we hope it has inspired you to delve deeper into the craft. With Zenva, you’re never alone on your voyage. We’re here to provide you with the expert insights and comprehensive courses to transform your imaginative concepts into tangible, interactive experiences. So animate those sprites, code with confidence, and let the games begin! 🚀

Python Blog Image

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