Godot Integration

This guide covers importing AutoSprite exports into Godot 4.x using AnimatedSprite2D.

Quick Start

Detailed Setup

SpriteFrames Resource

SpriteFrames is Godot's way of organizing sprite animations. Each SpriteFrames resource can contain multiple animations.

Creating animations:

1. Click + Add Animation in the SpriteFrames panel
2. Name it (e.g., "walk", "run", "jump")
3. Click the grid icon to add frames from spritesheet
4. Set columns and rows to match your layout
5. Click frames to select them in order
6. Click Add Frames

Frame Import Settings

When importing from a spritesheet:

Animation Properties

For each animation in SpriteFrames:

• Loop - Toggle for looping animations (idle, walk, run)
• Speed - Frames per second (default 5, try 12-24)
• Frame order - Drag to reorder frames

Node Setup

Your character scene hierarchy:

CharacterBody2D
├── AnimatedSprite2D
├── CollisionShape2D
└── ... (other nodes)

AnimatedSprite2D Properties

GDScript Example

Here's how to control animations in GDScript:

extends CharacterBody2D

@onready var animated_sprite = $AnimatedSprite2D

var speed = 200.0
var jump_velocity = -400.0

func _physics_process(delta):
    # Handle gravity
    if not is_on_floor():
        velocity.y += 980 * delta

    # Handle jump
    if Input.is_action_just_pressed("jump") and is_on_floor():
        velocity.y = jump_velocity
        animated_sprite.play("jump")

    # Get movement input
    var direction = Input.get_axis("move_left", "move_right")

    if direction:
        velocity.x = direction * speed
        # Flip sprite based on direction
        animated_sprite.flip_h = direction < 0
        # Play walk or run animation
        if is_on_floor():
            if Input.is_action_pressed("run"):
                animated_sprite.play("run")
            else:
                animated_sprite.play("walk")
    else:
        velocity.x = move_toward(velocity.x, 0, speed)
        if is_on_floor():
            animated_sprite.play("idle")

    move_and_slide()

func attack():
    animated_sprite.play("attack")
    # Wait for animation to finish
    await animated_sprite.animation_finished
    animated_sprite.play("idle")

Handling Directions

For 4-directional movement (top-down games):

extends CharacterBody2D

@onready var animated_sprite = $AnimatedSprite2D

var facing_direction = "down"

func update_animation(direction: Vector2):
    if direction.length() > 0:
        # Determine facing direction
        if abs(direction.x) > abs(direction.y):
            facing_direction = "right" if direction.x > 0 else "left"
        else:
            facing_direction = "down" if direction.y > 0 else "up"

        animated_sprite.play("walk_" + facing_direction)
    else:
        animated_sprite.play("idle_" + facing_direction)

This requires naming your animations:

• idle_down, idle_left, idle_right, idle_up
• walk_down, walk_left, walk_right, walk_up
• etc.

Alternative: Sprite2D + AnimationPlayer

If you prefer AnimationPlayer over AnimatedSprite2D:

This method gives you more control over animation events and blending.

Import Tips

Import Settings (FileSystem)

Select your spritesheet in Godot's FileSystem and check the Import tab:

Click Reimport after changing settings.

Common Issues

Sprites look blurry:

• Set Filter to "Nearest" in import settings
• Disable mipmaps

Animation speed is wrong:

• Adjust FPS in SpriteFrames panel
• 12 fps is good for pixel art

Frames in wrong order:

• Drag frames in SpriteFrames editor to reorder
• Or re-import selecting frames in correct order

Learn More

• Godot 2D Sprite Animation Manual
• AnimatedSprite2D Class Reference
• SpriteFrames Class Reference

Need Help?

Our community can help with Godot-specific questions!