Key Concepts

v1.0

This page provides a brief overview of the key concepts in Juicy Actions. Please see the more in-depth docs for more in-depth details.

Actions

Actions are classes which derive from Action.cs and are brought into your project as a Scriptable Object.

Each action generally does one thing, or a very small number of things. They can do game logic, UI, game feel / juice, and much more.

Writing New Actions

The Action.cs class has a large amount of comments intended to help humans an AIs create new actions. While there are over 100 actions shipped with Juicy Actions, devs can create custom actions to accomplish unique tasks, or to better integrate with their own systems and classes.

Actions

Action Executor

The ActionExecutor class holds a collection of actions — individual actions and "Groups" of actions. This is the class responsible for executing actions at runtime.

To utilize this, add a public ActionExecutor myActions; to your class. The Action Executor will be displayed in the Inspector.

"Action On Event" Components

There are additional components that can be added to your objects which have Action Executors already attached. ActionRunner, ActionOnTap, ActionOnTrigger, and more.

Add these to your objects, and you can make use of them quickly.

Start execution on an Action Executor by calling myActions.Execute(this);

Action Executor

Blackboard

Juicy Actions ships with a Blackboard class. There is a global Action Blackboard object which will be automatically brought into your scenes. Each ActionExecutor also has its own Blackboard, which can be used by Action objects at runtime.

The Blackboard is useful for storing information and allowing other objects to look up that data, or be notified of changes.

Action Blackboard

Juicy Actions Clock

Juicy Actions also ships with a clock. This enables actions to utilize a Timescale that is separate from the Unity Timescale, but also adheres to changes to the Unity Timescale. If you'd like objects to be able to pause through actions, often to freeze time for a moment, you may wish to ensure they utilize the Juicy Actions Clock.

You can easily connect this clock with Magic Time - Local Time Scales or other 3rd party clocks, or your own.

Clock & Time Scales