GlobalTweens V2.0 (Animation Tween Plugin)

Resources Plugins
,
1

GlobalTweens

Sorry i don’t have images, but you can play demo

Universal Tween Toolkit for Godot 4.x — One line. Infinite motion. Develop without overthinking.

This repository hosts two versions of the same toolkit, kept on separate branches so
that each one stays clean and self-contained:

Version Branch What it is
v1 — Classic main The original toolkit: a single root GlobalTweens.gd singleton with 69+ ready-to-use tween animations, plus the tweens-demo/ example project.
v2 — Refactored (this branch) v2 Full rewrite as a proper Godot plugin: 153 curated catalog animations in 16 categories, the original 112+ classic helpers (backward compatible), a safety layer (GT_Safe), anti-spam, unified options, interactive demo, full docs and a headless self-check.

Note: the two branches are intentionally not merged. v2 replaces main’s file
layout entirely (root GlobalTweens.gd and tweens-demo/ exist only in v1). If you
want to adopt v2 as the default, merge the v2 branch into main.

v2 at a glance

  • Catalog mode — GlobalTweens.play(node, "category.name", opts):
    16 categories: hit, jump, death, squish, slime, player, boss,
    ui_buttons, ui_text, ui_generic, environment, fog, flash, camera, fx, generic.
  • Classic mode — the original helpers, unchanged: pop_scale, shake, float_loop,
    beat_pulse, camera_trauma, scene_fade_change, … all 112+ functions.
  • Safety layer (GT_Safe) — every animation snapshots the node state before
    running and restores it when finished, stopped or killed. A node can never be
    left permanently distorted, even after spamming animations.
  • Anti-spam — one active animation per kind per node; new plays kill old ones and
    restore their start state.
  • Unified options — dur, loops, delay, trans, ease work the same way
    across every animation.
  • Error handling — invalid calls (null/freed nodes) never crash: choose
    GlobalTweens.error_mode = "crash" | "warn" | "ignore".
  • Interactive demo — examples/demo_scene.tscn (run the project to explore).
  • Self-check — tools/selfcheck.tscn plays every animation headless and reports
    errors: godot --headless --path . res://tools/selfcheck.tscn.

Repository layout (v2)

addons/global_tweens/
  global_tweens.gd        autoload singleton (classic helpers + catalog dispatcher)
  core/                   gt_safe.gd, gt_factory.gd, gt_catalog.gd
  categories/             16 category scripts, one per animation family
  plugin.cfg
docs/                     README, ANIMATIONS (full catalog), OPTIONS, SAFETY, CLASSIC
examples/                 demo scene + script
tools/                    self-check scene (headless validation)
project.godot             autoload + demo main scene already configured

Quick start (v2)

# Catalog mode (recommended)
GlobalTweens.play($Enemy, "hit.knockback", {"dir": Vector2.LEFT, "power": 120.0})
GlobalTweens.play($Player, "player.dash", {"dur": 0.25})
GlobalTweens.play($TitleLabel, "ui_text.emphasis")

# Await a tween
await GlobalTweens.play($Enemy, "jump.arc", {"height": 80.0}).finished

# Classic helpers (backward compatible)
GlobalTweens.pop_scale($Button, 1.3, 0.2)
GlobalTweens.float_loop($Coin, 8.0, 2.0)

# Control
GlobalTweens.stop($Enemy)         # kill + restore
GlobalTweens.stop_all()           # stop everything
GlobalTweens.reset($Enemy)        # stop + clear pause

Installation (v2)

  1. Copy the addons/global_tweens/ folder into your project.
  2. Enable the plugin: Project > Project Settings > Plugins > enable GlobalTweens
    (this registers the GlobalTweens autoload automatically).
  3. Done — the global GlobalTweens singleton is available everywhere.

GlobalTweens V2

License

MIT — free to use, modify, and distribute.

2 Likes
2

Hi there!

Nice collection of tweens!

I have a question, is everything contained in global_tweens.gd – so is it ok do delete the other directories core and categories and the code will still work?

Also, what does stop everything mean?

Is it advisable to call stop_all() after each time one calls GlobalTweens.play()?
What is the intended usage here? Maybe you could show with some usage examples how one can dispatch two tweens in parallel with GlobalTweens.

1 Like
3

Hi there, nice question

1. File Structure (v1 vs v2)

  • In v1: Everything was contained within a single global_tweens.gd file (Autoload or via class)
  • In v2: The library has been restructured into a modular architecture. global_tweens.gd acts as the main entry point/facade, but it relies on the scripts inside core/ and categories/
    Do NOT delete core or categories if you are using v2, as the project will break

2. What stop_all() means & When to use it

GlobalTweens.stop_all() is a global kill-switch. It immediately stops and removes all active tweens currently managed by the autoload across your entire game

  • Is it advisable to call stop_all() after play()?
    No, absolutely not. If you call stop_all() right after play(), it will immediately terminate the tween you just started before it even has time to animate
  • When should you use it? Only during major resets, scene transitions, pause menus, or when you explicitly want to clear all running background animations at once
  • Memory & Lifecycle: Tweens are non-blocking, self-cleaning, and automatically free themselves when finished or if the target node is queue_freed

3. Intended Usage & Parallel Tweens

By default, every helper function in GlobalTweens is asynchronous and non-blocking (fire-and-forget)

Parallel Execution (Default)

To run multiple tweens at the same time, simply call them one after the other without waiting

# Both tweens will start and run in parallel:
GlobalTweens.shake($Camera2D, 10.0, 0.4)
GlobalTweens.spawn_in($Enemy)

Imma working on a demo for version 2, it will be available soon on my Itchio page

immagine
immagine554×602 38.1 KB

1 Like