Reuse a DefinitionReuse a Definition

A tween definition is a motion you can re-use on any compatible Node.

Animations are paused

Reduce Motion is on, or Animation Effects are off.
(e.g. in your accessibility settings)

Enable this demoApplies to this demo until you reload.

0.00 s0.20 s0.40 s0.60 s0.80 s

var hop = new Tweens.Position2DY
{
    By = -80,
    Duration = 0.25,
    Ease = Out.Quad,
    PingPong = true,
};

for (var i = 0; i < icons.Length; i++)
    icons[i].Tween(hop with { Delay = i * 0.2 });

Height on the definition

80 px

Stagger on each copy

0.20 s

Changes apply to the next wave. Icons in the air keep the settings they started with.

Scripting it

In a 2D scene, drag icon.svg into the viewport a few times, side by side. Attach this script to the scene’s root Node2D and run it.

HopWave.cs

using System.Linq;
using Godot;
using tweens.gd;

public partial class HopWave : Node2D
{
    public override void _Ready()
    {
        var hop = new Tweens.Position2DY
        {
            By = -80,
            Duration = 0.25,
            Ease = Out.Quad,
            PingPong = true,
        };

        var icons = GetChildren().OfType<Node2D>().ToArray();
        for (var i = 0; i < icons.Length; i++)
            icons[i].Tween(hop with { Delay = i * 0.2 });
    }
}

1. Define once. hop lifts a node 80 pixels and drops it back; negative y is up in Godot. By is relative, so each icon hops from wherever it stands.
2. Find the nodes. Every Node2D child of this node.
3. Start a copy on each. with copies hop and changes only Delay, so hop itself keeps no delay. Each start returns its own handle.

Each start snapshots its definition. Change hop later, and only the starts after that follow; tweens already playing keep their settings.

Would you like to know more?

AnatomyEvery field a definition can set.

VariationsScale or shift a copy relative to the original.

Keep reusable motion nearby

Store a shared definition in a static readonly field of a class you can use as your animation design system (or theme), shared across your project. The generated definitions are readonly record structs.