> 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/ultimate-stats-framework/installation-and-setup.md).

# Installation and Setup

Install Ultimate Stats Framework from your Fab Library, enable it in Unreal Engine, and prepare a project namespace in Stats Designer.

## Supported Engine Versions

The initial release has been built and validated on Unreal Engine 5.5, 5.6, 5.7, and 5.8 for Win64. Install the plugin version that matches your project's Unreal Engine version.

## Install from Fab

1. Open your Epic Games Launcher and locate Ultimate Stats Framework in your Fab Library.
2. Click **Add to Engine**. Depending on your Launcher version, this action may be shown as **Install to Engine**.
3. Select the Unreal Engine version used by your project and complete the installation.
4. Open your Unreal Engine project.
5. In Unreal Editor, open **Edit > Plugins**.
6. Search for Ultimate Stats Framework and enable the plugin.
7. Restart Unreal Editor when prompted.

After the editor restarts, Ultimate Stats Framework is installed and ready to use.

<figure><img src="https://2218703886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4YPyrdOyfjDGtlxlvjSd%2Fuploads%2FhykCQNp3Y85xHpMrgMjt%2Fimage.png?alt=media&amp;token=d0718779-f25d-4680-a78a-d4efe012944b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2218703886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4YPyrdOyfjDGtlxlvjSd%2Fuploads%2Fhag0GWaLr1yuiV1BZAKv%2Fimage.png?alt=media&#x26;token=f178aca1-7a73-4554-b7dd-b119808c16f9" alt=""><figcaption></figcaption></figure>

## Run Setup

Open the top editor menu and select RooGame > Core > Setup. On the Default tab, click Repair / Install RooGame.

Setup checks for `Config/DefaultGameplayTags.ini`. If the file does not exist, Setup creates a valid empty Gameplay Tags config. If the file already exists, Setup leaves it unchanged.

Setup does not install a fixed RooGame tag hierarchy. Stat and Attribute roots are created by each Stats Designer according to that Designer asset's Tag Namespace.

<figure><img src="https://2218703886-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4YPyrdOyfjDGtlxlvjSd%2Fuploads%2FcNh0izp6eiXgtsQgB98L%2Fimage.png?alt=media&#x26;token=852c9d90-aff5-47e6-8743-d2f9f7154a02" alt=""><figcaption></figcaption></figure>

If your project already has `DefaultGameplayTags.ini`, you can continue directly to Stats Designer.
