Usage Guide - Game Juice Pro

1. In the Content Browser, right-click → Game Juice Pro → Juice Preset.

2. Open the created preset. You will see the empty Feedback Templates array.

3. Click the + button to add feedbacks. Select the type you need from the list (e.g.: Camera Shake, Scale, Sound, etc.).

4. Configure each feedback to your liking. Each type has its specific properties (see the Feedback Catalog).

5. Optionally, adjust the global preset properties: Intensity Multiplier, Duration Multiplier, Sequential.

1. In the Blueprint where you want to trigger the effect, right-click and search for "Play Juice".

2. Connect the Target pin to the actor that will receive the effect (e.g.: the character, an enemy, an object).

3. In the Preset pin, select the Juice Preset you created.

4. Optionally, adjust the Intensity (0-1). A lower value produces a subtler effect.

5. If you're in a multiplayer project and want the effect to be local only, enable Skip Replication.

6. The node returns a Session ID through its output pin. If you need to stop this preset later (e.g.: remove a Rim Glow effect on end overlap), store that ID in a variable.

7. Run the game and trigger the event. The preset feedbacks will play on the target actor.

The Game Juice Component is optional. Use it when you need independent sessions, auto-play, component-level cooldowns or advanced network configuration.

1. Open your actor's Blueprint and add the "Game Juice Component".

2. Configure the component properties as needed (see Core Concepts).

3. Call Play Preset on the component passing the preset, position and intensity. The component returns a Session ID that you can use to stop that specific session.

Include the main header and use the static function PlayGameFeel:

#include "GameFeelPro.h"

// Play a preset on an actor
// Returns the Session ID (>= 0 success, -1 failure)
int32 SessionId = UGJPFeedbackLibrary::PlayGameFeel(
    this,           // WorldContextObject
    MyActor,        // Target actor
    MyPreset,       // UGJPFeedbackPreset*
    1.0f,           // Intensity (0-1)
    false           // bLocalOnly (Skip Replication)
);

// Stop that specific session later
UGameJuiceComponent* JuiceComp = MyActor->FindComponentByClass<UGameJuiceComponent>();
JuiceComp->StopSession(SessionId);

The Play Juice node returns a Session ID that you can store in a variable. Use that ID on the actor's Game Juice Component to control the session:

• Stop Session (ID): Stops a specific session by its ID, without affecting other active sessions
• Stop Preset: Stops all sessions of a specific preset
• Stop All Sessions: Stops everything in the component
• Get Active Session Count: Returns the number of active sessions
• Refresh Base Scale: Recaptures the actor's base scale after intentional changes

• Start with small presets (2-3 feedbacks) and iterate. It's easier to adjust game feel gradually.
• Combine subtle feedbacks: a small Camera Shake + Scale + Sound can produce great results.
• Leverage presets to standardize game feel: create presets like "Light Hit", "Heavy Hit", "Pickup", "Level Up".
• Use the Intensity pin on the Play Juice node to reuse the same preset with different intensities depending on context.
• Use Chance with values below 100 to add variation to frequently repeating effects.