/godot-tweening

Tween recipes and gotchas

Expert scripts own interruptible UI — these are supporting recipes.

Kill before recreate

var current_tween: Tween
func animate_to(pos: Vector2) -> void:
    if current_tween and current_tween.is_valid():
        current_tween.kill()
    current_tween = create_tween().bind_node(self)
    current_tween.tween_property(self, "position", pos, 1.0)

MANDATORY: safe_tween_interruption.gd.

finished signal

var tween := create_tween()
tween.tween_property($Sprite, "position", Vector2(100, 0), 1.0)
tween.finished.connect(_on_tween_finished)

Chained fade-move-fade

var tween := create_tween()
tween.tween_property($Sprite, "modulate:a", 0.0, 0.5)
tween.tween_property($Sprite, "position", Vector2(200, 0), 0.0)
tween.tween_property($Sprite, "modulate:a", 1.0, 0.5)

Bezier path

Tween PathFollow2D.progress_ratio — see Expert Patterns in SKILL.md.

Gotchas