Juicebox Pro (Godot 4.x)

Juicebox Pro is a modular "game feel" library for Godot 4.x designed to eliminate boilerplate code for common feedback loops. It provides drag-and-drop components for screen shake, procedural animation, and VFX management.

• License: MIT
• Version: 1.0.4

Core Components

1. JuiceCamera2D (extends Camera2D)

A robust implementation of the "trauma" screen shake algorithm.

• Cubic Intensity: Uses non-linear decay (pow(trauma, 3)) for high-impact shakes that settle instantly without floating.
• Stress Scaling: Oscillation frequency scales dynamically with trauma intensity.
• Axis Decoupling: Uses independent noise seeds for X, Y, and Roll to prevent diagonal locking.

2. SquashStretch (extends Node)

Procedural elastic deformation for sprites.

• Parent Targeting: Automatically manipulates the parent node's scale.
• Lerp Physics: Uses delta-time interpolation to snap back to identity (Vector2.ONE).
• API: Includes trigger_jump() and trigger_land() methods for immediate integration with CharacterBody state machines.

3. JuiceAnimator (extends Node)

A lightweight, code-driven frame cycler.

• Alternative to AnimationPlayer for simple sprite sheets.
• Ideal for handling discrete states (Idle, Run, Hurt) without blending overhead.

VFX Utilities

• ImpactFrame: Manages hitstop (freeze frames) by manipulating Engine.time_scale. Supports optional screen flashing.

• GhostTrail: Spawns decoupled sprite copies in global space for dash/speed after-images.

• PopLabelManager: A physics-based floating text system. Handles velocity, gravity, and horizontal jitter for combat damage numbers.

Installation

1. Download the release archive.
2. Extract the juicebox_pro folder into your project's addons/ directory.
3. Enable the plugin via Project > Project Settings > Plugins.