GS_Stats
GS_Stats provides the statistical and modifier infrastructure for RPG-style character systems. It handles the application, tracking, and expiry of status effects — the layer between raw gameplay events and the numerical state of a character.
For architecture details, component properties, and extending the system in C++, see the GS_Stats API.
Quick Navigation
| I want to… | Feature | API |
|---|---|---|
| Apply timed or permanent modifiers to entity stats with stacking and expiry | Status Effects | API |
Installation
GS_Stats requires GS_Core. Add both gems to your project.
For a full guided walkthrough, follow the Simple Project Setup guide.
Quick Installation Summary
- Enable the GS_Stats gem in your project configuration.
- Define status effect data assets for your game’s modifiers.
- Place status effect components on entities that need to receive modifiers.
Status Effects
Status Effects are the primary mechanism for applying timed or permanent modifiers to entities. Each effect defines what it changes, how long it lasts, whether it stacks, and what happens on expiry. The system handles the full lifecycle: application, duration tracking, stack management, and cleanup. Effects are data-driven — designers author new types in the Asset Editor without touching code.
See Also
For the full API, component properties, and C++ extension guide:
Get GS_Stats
GS_Stats — Explore this gem on the product page and add it to your project.