GS_Actions

A utility system for triggerable single-purpose actions — fire discrete behaviors from any system without recoding logic for each component.

Tags:

The Actions system provides a simple, universal pattern for triggering discrete behaviors. Instead of recoding common functionality (toggle cursor, play sound, print log) into every component that needs it, you attach Action components to an entity and fire them by channel name.

Actions support chaining — when one action completes, it can fire another action on a different channel, enabling lightweight sequences without custom code.

For usage guides and setup examples, see The Basics: GS_Core.

Architecture

Entity with Actions
  │
  ├── ToggleMouseCursor_GSAction (channel: "enter_menu")
  ├── PlaySound_GSAction           (channel: "enter_menu")
  └── PrintLog_GSAction            (channel: "debug")

Any system calls:
  ActionRequestBus::Event(entityId, DoAction, "enter_menu")
    → Both ToggleMouseCursor and PlaySound fire (matching channel)
    → PrintLog does NOT fire (different channel)

Components

Component	Purpose	Documentation
GS_ActionComponent	Base class for all actions. Handles channel matching, completion broadcasting, and action chaining.	Action
ToggleMouseCursor_GSActionComponent	Toggles the mouse cursor on or off.	Core Actions
PrintLog_GSActionComponent	Prints a message to the console log.	Core Actions

Quick Start

Attach one or more Action components to an entity.
Set the Channel on each action to control when it fires.
From any system, call DoAction(channelName) on the entity’s ActionRequestBus to trigger matching actions.
Optionally enable Broadcast On Complete and set an On Complete Channel Chain for action sequencing.

Get GS_Core

GS_Core — Explore this gem on the product page and add it to your project.