JuiceBox: Game Feel Kit for Godot 4

Make every hit feel like it matters.

You know that feeling when a game hits hard? The screen jolts, the enemy flashes white, time freezes for a split second, a big yellow CRIT! pops out... That's juice, and it's the cheapest way to make your game feel ten times better.

JuiceBox gives you all of it in one line:

```

Juice.impact($Sprite2D, 1.0, hit_direction)

```

No more rewriting the same screen-shake script for every jam game.

---

✨ What's inside

🎥 JuiceCamera: a drop-in Camera2D replacement

- Trauma-based shake (the GDC-talk method): smooth noise, never jittery

- Directional kick: the camera shoves in the direction of the hit

- Zoom punch for heavy impacts

- A global 0–100% shake setting, ready for your accessibility menu

⏸️ Hit-Stop

- Freezes frames on impact, like fighting games do

- Handles overlapping hits safely, so time scale is never left stuck at 0

🟢 Squash & Stretch

- Physically springy (not a canned tween)

- Squash on landing, stretch on jump, wobble on hit

⚪ Hit Flash Shader

- White (or any color) damage flash for any Sprite2D or AnimatedSprite2D

💥 Damage Numbers

- Floating, fading, pooled (no garbage-collection spikes)

- Crits pop bigger, in gold, with a bounce

- Survive scene changes

🎮 Demo project: click a dummy, toggle the juice on and off, and feel the difference.

---

⚡ Setup in 2 minutes

1. Drop `addons/juicebox` into your project

2. Enable the plugin

3. Swap your Camera2D for a JuiceCamera

4. Add Flash / Squash child nodes to your sprites

5. Call `Juice.impact()`. Done.

Every value is an `@export`, so you can tune the feel in the Inspector without touching code.