> For the complete documentation index, see [llms.txt](https://roogame.gitbook.io/roogame/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roogame.gitbook.io/roogame/roo-gameplay-framework/stats-system.md).

# Stats System

The Stats System provides persistent numeric stats, bounded attributes, formulas, progression tables, modifiers, and reusable stat actions.

## Pages

* [Stats Component](/roogame/roo-gameplay-framework/stats-system/stats-component.md): initialize runtime values and use the public API.
* [Formulas and Progression Tables](/roogame/roo-gameplay-framework/stats-system/formulas-and-progression-tables.md): build calculated values and level curves.
* [Modifiers and Stat Actions](/roogame/roo-gameplay-framework/stats-system/modifiers-and-stat-actions.md): apply equipment bonuses, damage, healing, and reusable value changes.

## Typical Flow

1. Define unique Stat and Attribute Gameplay Tags.
2. Create a Stats Designer asset or individual data assets.
3. Add definitions to a Stats Set.
4. Assign the Stats Set to a Roo Stats Component.
5. Read and change values by Gameplay Tag or Name.
6. Bind UI and gameplay logic to component events.