CancellationCancellation

Awaiting a tween resumes however it ends, cancelled or not. Check the reason when the next step needs the motion to have arrived.

Examples use using Godot; and using tweens.gd; in a Node method, with targets inside the scene tree.

Cancel playback

movement.Cancel() stops a tween where it is and resumes everything awaiting it. Groups and Chains cancel the same way, and sprite.CancelTweens(includeChildren: true) cancels everything a node and its descendants own.

Continue only on success

Godot's Tween

var tween = sprite.CreateTween();
tween.TweenProperty(sprite, "position", new Vector2(400, 180), 0.6);
await ToSignal(tween, Tween.SignalName.Finished); // Not emitted if killed.

sprite.CreateTween().TweenProperty(sprite, "modulate:a", 0f, 0.3);

tweens.gd

var movement = sprite.TweenPosition((400, 180), 0.6);
if (await movement.End != Reason.Completed)
    return;

sprite.TweenModulateAlpha(0, 0.3);

Godot doesn’t emit finished for a killed tween, so code awaiting it never continues. End always resumes with a reason: here, the fade runs only after the sprite arrives, and never on a sprite freed along the way.

Why it ended

Reason	Meaning
Completed	Reached the natural end
Cancelled	Cancelled through a handle or CancelTweens
TargetFreed	Target was queued for deletion, or found freed or disposed
OwnerExited	Owner left the tree, or a separate owner was queued for deletion
RunnerDisposed	Tree or scheduler shut down

Errors throw instead: a start with invalid arguments throws at the call, and awaiting End rethrows a fault from an easing, setter, or callback.

Compare against Completed

A node that owns its tween, as node targets do by default, reports TargetFreed after QueueFree() but OwnerExited after Free(), because Free() removes it from the tree before deleting it. Test for Completed rather than a particular early reason.

Cancel a wait, not the tween

await movement.AwaitDecommissionAsync(token) stops waiting when token is cancelled, and throws OperationCanceledException. Playback and other waiters continue. Chains have the same method.

HandlesControls, states, wait helpers, and errors.