> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musterbox.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Unreal Engine

> Integrate the MusterBox SDK with Unreal Engine 5.3/5.4.

The Unreal adapter ships as a plugin named **`MusterBox`** (plugin package
`musterbox-unreal`, min Engine version **5.3**; validated against 5.4).

## Install

Extract the plugin into your project's `Plugins` directory and enable it:

```bash theme={"dark"}
# dist/unreal/musterbox-unreal-1.0.0.zip
#   -> <Project>/Plugins/MusterBox
```

Enable the plugin in **Edit > Plugins > MusterBox**, then restart the
Editor.

## Use from C++

```cpp theme={"dark"}
#include "MusterBox/Public/MusterBox.h"

auto* SDK = UMusterBox::Get();
SDK->Initialize(Config{ .GameId = "my-arena-game", .GameKey = "gk_...", .Environment = "sandbox" });
SDK->Start();
SDK->Authenticate("player@example.com", "secret");
FSessionContext Ctx = SDK->OpenSession("sandbox", 1042);
```

## Use from Blueprint

The module exposes Blueprint-friendly functions for the core flow:

* `Initialize`
* `Start` / `Shutdown`
* `Authenticate`
* `OpenSession`
* `SubmitResult` / `SubmitEvent`
* `GetStatus` / `GetDiagnostics`

Call `Tick` from your GameMode/GameInstance per frame if you use Manual
runtime mode, or leave the default Threaded mode for background processing.

## Support matrix

| Unreal Engine | SDK   | Plugin      |
| ------------- | ----- | ----------- |
| 5.3, 5.4      | 1.0.0 | `MusterBox` |

Next: [Bevy](/engines/bevy).