🧃 Juicee

Game feel for Godot 4. Screen shake, hit-stop, squash, particle bursts, damage numbers, and a bunch more. Fire them in one line, or stack them into sequences. Free and MIT.

_{Its own animation clips and dust, with Juicee's squash and stretch, widening view on the run and landing shake on top. Character: Godot Plush Character by Tibo, MIT}

A single shake is five lines with a tween, and if that is all you need, write it. Juicee is for the moment effects collide, because that is where the bugs are:

• Two shakes at once on one camera both show, and leave it where it started, not where the first one left it.
• Two hit-stops in a row cannot leave Engine.time_scale stuck at zero.
• stop() halfway through takes the ducked music, the reverb and the full-screen overlay with it.
• A node freed in the middle of an effect is let go without an error.
• Two rumbles at once combine, instead of the second one cancelling the first.

What it does not do is blend a tween with a loop-driven effect on the same property: the tween wins. Juicee warns you when that happens, rather than letting the loop quietly do nothing.

The fastest way in is the singleton. Call it from anywhere:

Juicee.stretch(tomato, Vector2.UP) # a smear as it launches Juicee.trail(tomato) # a ghost trail through the arc Juicee.hop(tomato, 50, 0.55) # the hop itself await get_tree().create_timer(0.15).timeout Juicee.sparkle(tomato) # a burst of stars at the top await get_tree().create_timer(0.4).timeout Juicee.squash_land(tomato) # flatten on landing await get_tree().create_timer(0.42).timeout Juicee.jelly_wobble(tomato) # a springy jelly settle

If you'd rather not pick effects one by one, there are 12 presets that bundle a few together:

Juicee.preset_hit(enemy)
Juicee.preset_explosion(self)
Juicee.preset_level_up(self)
Juicee.preset_pickup(coin)
# ...and 8 more

Same effects, three workflows. Pick whatever suits you:

• Singleton: one line from code, like above.
• Inspector: add a JuiceePlayer node and build a sequence with sliders, with a Preview button to try it without running the game. One player can hold several sequences and fire them by name, play("hit") or play("death"), the way an AnimationPlayer does.
  • Right-click any node in the Scene dock for an "Add JuiceePlayer" shortcut, one per node on a multi-selection (Godot 4.4 and up).
  • Park the player wherever it belongs: an effect that lands on the wrong kind of node looks for the right one nearby, so a player next to the sprite still bounces it.
  • A step that cannot work, a Sound with no streams or an effect with no node of its kind anywhere near, shows as a warning on the player in the Scene dock before you run anything.
• Graph editor: wire effects together in the JuiceeGraph bottom panel, with Trigger / Loop / Random / Split nodes for flow. Play the saved graph with JuiceeGraphPlayer.play(graph, node) and it runs with the branching intact, no flattening. A minimap, Align and Ctrl+F help once a graph outgrows the screen.

Inspector: every row has its own play button, drags to reorder, and right-clicks to mute, duplicate or reset	Hover a row and the effect plays on a copy of your own sprite
	Add Effect: all 117 by category, or type to search names and descriptions
Graph editor: Trigger, Split, Loop and Random for flow, effect blocks coloured by category

Sequences and graphs are plain resources. A sequence goes on a JuiceePlayer or plays from code; a graph plays from code, or turns into a flat sequence with Export Sequence when it has no branching to keep.

With the game running, select a JuiceePlayer and change any value in the Inspector or the graph: the running game picks it up as you change it, so you tune by feel instead of relaunching. See live-tuning.md.

1. Get Juicee from the Godot Asset Store, or copy addons/juicee/ from this repository into your project's addons/ folder.
2. Project Settings > Plugins > enable Juicee.

Needs Godot 4.3 or newer; the test sweep runs on 4.3, 4.4, 4.6 and 4.7. Works in all three renderers (Forward+, Mobile, Compatibility).

To update, use Update in the JuiceeGraph toolbar, or delete addons/juicee/ and install the new version. An update writes over that folder and a reinstall deletes it, so keep your own effects outside it (see juicee/effect_folders below). Coming from 1.x? Some defaults and timings changed, and upgrading.md says which and how to get the old look back.

_{Juicee on the Godot Asset Store}

_{Pixel art at 128x72, scaled up by a whole number. Its own clips, with Juicee's squash and stretch, wobbles, breathing and bob on top. Character: Simply Plush by SplendidDog}

117 effects across 8 categories. Eight of them, one call each on the quick start's tomato:

_{Juicee.hit_spark(tomato), Juicee.damage_number(tomato, 42) and so on, everything else left at its default}

Every effect has a few shared knobs: chance, delay, a random intensity range, cooldown, enabled to mute it, and stop() / is_playing(). Any single play can be scaled with apply(node, {"intensity": 1.8}), so a light hit and a heavy one share one sequence; effects that switch or time something rather than having a strength (Flip, Instantiate, Screen Wipe, the Flow steps and a few more) play the same either way.

Godot compiles a shader the first time it is drawn, so the first screen effect of a session can stall a frame. Call await Juicee.warmup() on a loading screen to pay that up front.

Five global toggles for reduced motion, flashing, screen shake, chromatic and vibration, which every effect reads on its own, plus an overall intensity and a quality tier that thins out the particle-heavy effects for weaker hardware. addons/juicee/ui/accessibility_settings.tscn drops all of it into an options menu as one node, and Juicee.accessibility.to_dict() / from_dict() carry it in and out of your save file.

Turn on Advanced Properties (Project Settings > Juicee, or the checkbox in the inspector header) and every effect opens up: 289 more parameters across the library. Hand-drawn easing curves, shake presets, particle shapes, star shapes, audio properties Godot always had but Juicee never exposed. The switch only shows and hides them, so turning it on changes nothing by itself, and all but four default to what the effect already did; upgrading.md names those four. See advanced-properties.md.

Everything under Project Settings > Juicee:

The whole singleton API works from C# as well:

Juicee.ShakeCamera(this, 12f, 0.3f);
Juicee.HitStop(this, 0.08f);
Juicee.PresetHitCrit(this);

You need the .NET build of Godot. See docs/csharp.md.

Made an effect or preset worth sharing? Open a PR, or post it in Discussions.

MIT. Use it in anything, free or commercial.

_{Asset Store · Discussions · Issues · Changelog}