> 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/editor-tools/stats-designer.md).

# Stats Designer

Stats Designer is an editor workspace bound to a Roo Stats Designer Data Asset.

In the Content Browser, open the directory that should own the generated Stats assets. Right-click and select `RooGame > Stat > Roo Stats Designer`, then double-click the new Designer asset.

## Tag Namespace

The Tag Namespace field at the top belongs to the current Designer Data Asset. A newly created Designer defaults to `RooGame`. Set a project-specific namespace before adding definitions when you do not want to use that default.

For example, `MyGame` produces:

```
MyGame.Stats
MyGame.Stats.Stat
MyGame.Stats.Attribute
```

Valid namespaces use letters, numbers, underscores, and dots. Leading and trailing dots are removed, empty segments are rejected, and spaces or other symbols are not accepted.

Changing the field immediately refreshes the Designer and switches the tag hierarchy shown in the left panel. It does not rename or migrate tags from the previous namespace, so choose the namespace before creating definitions and generated assets.

The included demo Designer uses `RooRPGDemo`. Reserve that namespace for the plugin demo and use a different namespace for production content.

## Left panel

The left panel reads Gameplay Tags under the current namespace:

```
<Namespace>.Stats.Attribute
<Namespace>.Stats.Stat
```

You can:

* Add config Gameplay Tags.
* Remove non-native config Gameplay Tags.
* Enable or disable a definition's center-table visibility.
* Drag definitions within the Attribute or Stat group to reorder them.
* Use Ctrl+Z to restore the most recently removed config line.

When the first definition is added, the Designer ensures `Config/DefaultGameplayTags.ini` contains the namespace, Stats, Stat, and Attribute roots. New definitions are written under the selected namespace.

Native tags remain visible but cannot be removed from project config through the Designer.

Changing order updates the center columns and stores Definition Order in the Designer Data Asset.

## Center table

Each row represents one Stats Set.

Attribute columns:

```
Attr.Name.Min
Attr.Name.MaxStat
Attr.Name.StartPercent
```

Stat columns:

```
Stat.Name.Base
Stat.Name.Formula
```

Use + to create a set row. Use - to delete the selected set and its generated set directory.

## Use

Click Use to create or update assets.

For a Designer located in a project folder, generated assets follow:

```
Designer Directory/
  Stats/
    SetName/
      DA_StatsSet_SetName
      Stats/
        DA_Stat_Name
      Attributes/
        DA_Attribute_Name
```

Generated Stat and Attribute assets use tags from the current Designer namespace. Use also saves generated packages and cleans assets that are no longer represented by valid definitions in this Designer's generated root.

## Refresh

Opening Stats Designer performs a refresh. Refresh scans the Designer's Stats directory, updates set rows, removes rows for missing set assets, and rebuilds the table from tags under the current namespace and the current assets.

## Inspector

Select a Stats Set row to inspect the generated Stats Set in the right panel.