# JUICY ACTIONS

## → Available on [**Asset Store**](https://assetstore.unity.com/packages/slug/269711?aid=1100lxWw\&pubref=docs)

## TL;DR

At its core <mark style="color:yellow;">**Juicy Actions**</mark> is:

1️⃣ [**Actions**](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/actions) → Bite-sized code objects that generally do one thing

2️⃣ [**Action Executor**](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/action-executor) → Executes <mark style="color:yellow;">Actions</mark> at runtime with advanced logic. Add to your classes or use...

3️⃣ [**Action on Events / Action Runner**](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/action-on-events-and-action-runner) → Included classes which contain one or more <mark style="color:yellow;">Action Executors</mark>

Combine <mark style="color:yellow;">Actions</mark> to produce amazing game feel / juice, run logic, and more.

⊕ [Blackboard](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/action-blackboard), [Time Control](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/clock-and-time-scales), [Deterministic Random](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/deterministic-random)

## What is <mark style="color:yellow;">Juicy Actions</mark>?

<mark style="color:yellow;">**Juicy Actions**</mark> is a logic, visual effects, and game feel system for Unity that lets you create polished, responsive game animations, adjust settings, and perform logical operations without writing code. Bundle together movements, color changes, screen shakes, particles, sounds, and UI effects into reusable action sequences, then trigger them with a single line of code or built-in event components. Perfect for adding that satisfying "juice" to attacks, UI interactions, pickups, damage reactions, and level transitions—the polish that makes your game feel alive instead of flat.

Under the hood, <mark style="color:yellow;">Juicy Actions</mark> is built on a robust async/await architecture with full cancellation support, restart-safe execution, and a flexible dependency injection system. <mark style="color:yellow;">Actions</mark> are modular `ScriptableObjects` that can be sequenced, grouped, conditioned, and looped with <mark style="color:yellow;">Deterministic Randomization</mark> and shared state via <mark style="color:yellow;">Blackboard</mark>. The system supports custom time sources, per-action overrides, extensible clock resolution, and seamless integration with external frameworks—giving experts fine-grained control while keeping the beginner experience <mark style="color:$primary;">**as simple as dragging assets into inspector fields and hitting play**</mark>.

## Where to Start?

It's easy to start.

### Quick Start & Demo Scenes

The main package contains multiple demo scenes. You can learn about each demo scene in the [quick-start-and-demos](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/quick-start-and-demos "mention")section. Or get hand-on with <mark style="color:yellow;">Juicy Actions</mark> using the [super-quick-start-tutorial](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/quick-start-and-demos/super-quick-start-tutorial "mention").

Visit the [third-person-game-tutorial](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/quick-start-and-demos/third-person-game-tutorial "mention") for a more in-depth tutorial you can follow along with.

{% content-ref url="juicy-actions/quick-start-and-demos" %}
[quick-start-and-demos](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/quick-start-and-demos)
{% endcontent-ref %}

### Integrations

<mark style="color:yellow;">Juicy Actions</mark> provides integrations with multiple 3rd party assets. Visit the [integrations](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations "mention")page for details on each. Many integrations add additional <mark style="color:yellow;">Actions</mark> and other components to the toolset, specific to those other tools!

{% content-ref url="juicy-actions/integrations" %}
[integrations](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations)
{% endcontent-ref %}

Some popular integrations:

* [Playmaker](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/playmaker)
* [Feel](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/feel)
* [Dialogue System for Unity](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/dialogue-system-for-unity)
* [DoTween](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/dotween) (free version)
* [All in 1 3D-Shader](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/all-in-1-3d-shader)
* [Projectile Factory](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/projectile-factory)
* [Magic Time - Local Time Scales](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/clock-and-time-scales/magic-time-integration)
* [Game Modules 4](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/integrations/game-modules-4)

### Docs

The rest of the docs go deeper into each part of <mark style="color:yellow;">Juicy Actions</mark>, including code samples. Dig deep, learn more, and get some ideas on how to squeeze the most <mark style="color:yellow;">Juice</mark> out of this!

### Customization

When you're ready, create your own `Action` classes that speak directly to your project, your systems, and your tools. It's easy to create, either with your friendly AI or by yourself, and custom <mark style="color:yellow;">Actions</mark> will drastically increase the value you get from <mark style="color:yellow;">Juicy Actions</mark>!

{% content-ref url="juicy-actions/actions/write-custom-actions" %}
[write-custom-actions](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/actions/write-custom-actions)
{% endcontent-ref %}

## Support

{% content-ref url="juicy-actions/faqs-and-common-problems" %}
[faqs-and-common-problems](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/faqs-and-common-problems)
{% endcontent-ref %}

Find a bug? Got lost? Is my documentation super confusing?

Come to the [Discord](https://discord.com/invite/cmZY2tH) and open a ticket in the support channel!&#x20;

{% hint style="success" %}
Please note, I do have a full time job an a family. I try to check the support threads as often as possible, but I am not able to check every single day. I will reply when I am able! Thank you for understanding!
{% endhint %}

{% content-ref url="juicy-actions/faqs-and-common-problems" %}
[faqs-and-common-problems](https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions/faqs-and-common-problems)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://infinitypbr.gitbook.io/magic-pig-games/juicy-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.