GS_Stats
Categories:
GS_Stats provides the attribute and status effect layer for GS_Play projects. It gives entities a stat container that holds named, typed values (health, stamina, speed, and any custom stat you define), and a status effect system that applies timed or conditional modifications to those stats. GS_Stats is under active development — the API surface is evolving and some features listed here may expand in future releases.
For usage guides and setup examples, see The Basics: GS_Stats.
Contents
Status Effects
The status effect system applies timed or trigger-driven modifications to entity stats. Effects are polymorphic data assets that define what stat they target, how they modify it, and when they expire. Multiple effects stack on the same entity and resolve in a defined order.
| Area | Contents |
|---|---|
| Effect Assets | Data-driven effect definitions with target stat, modification type, magnitude, and duration. |
| Effect Container | Runtime component that holds the active effect stack for an entity and processes tick-based expiry. |
| Modification Types | Additive, multiplicative, and override modification strategies. |
| Conditions | Conditional triggers for applying or removing effects based on stat thresholds or game records. |
Installation
GS_Stats is a standalone gem with no external GS gem dependencies beyond GS_Core.
- Enable GS_Stats and GS_Core in your O3DE project’s gem list.
- Add the stat container component to any entity that requires tracked attributes.
- Define stat definitions in your project’s stat registry (data asset).
- Add status effect asset files to your project and reference them from abilities, items, or world triggers.
Note: GS_Stats is under active development. Check the changelog for the latest additions before starting integration work.
See Also
For conceptual overviews and usage guides:
For sub-system references:
For related resources:
Get GS_Stats
GS_Stats — Explore this gem on the product page and add it to your project.