ActionSystem

The Action System provides an async-based command pattern for defining, executing, and sequencing discrete units of gameplay logic. Actions are serializable, support cancellation, and expose a variable binding system for data-driven parameterization.

Architecture

Data Flow

Key Concepts

Concept	Description
Action	Abstract base class for a single unit of async work. Subclass and override OnExecute().
ActionSequence	Concrete Action that runs a list of child Actions in order.
ActionPlayer	MonoBehaviour that holds and plays a single Action from the Inspector.
IAction	Minimal interface for completing, cancelling, and accessing variables.
ActionVariables	Internal variable system supporting field-based and dynamic variables.

Execution Lifecycle

Quick Start

Creating a Custom Action

using System;
using System.Threading.Tasks;
using Paragon.Core.ActionSystem;
using Paragon.Core.Async;

[Serializable]
public class WaitAction : Action
{
    [Variable]
    private float duration = 1f;

    protected override async Task OnExecute()
    {
        await Yield.WaitForSeconds(duration);
    }
}

Running an Action

// Fire-and-forget
myAction.Execute();

// Awaitable
await myAction.ExecuteAsync();

// Cancel mid-execution
myAction.Cancel();

Building a Sequence

An ActionSequence is itself an Action, so sequences can be nested:

// ActionSequences are typically configured in the Inspector via Odin serialization.
// At runtime they execute each child action sequentially:
await mySequence.ExecuteAsync();

Classes

Class	Description
IAction	Interface defining the action contract
Action	Abstract base class for all actions
ActionPlayer	MonoBehaviour wrapper for Inspector-driven action playback
ActionSequence	Composite action that runs children sequentially