> ## 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.

# Compatibility

> The verified compatibility matrix for the MusterBox SDK 1.0.0.

This page is generated from the SDK's verified
`compatibility-matrix.json` and `compatibility-manifest.json`.

## Engine support

Matrix version 1.0, generated from the certification build
(SDK 1.0.0, protocol 1.0, config schema 1, C ABI 1.2.0).

| Engine        | Minimum | Tested versions                          | Package                  |
| ------------- | ------- | ---------------------------------------- | ------------------------ |
| Unity         | 2020.3  | 2020.3, 2021.3, 2022.3, 2023.1           | `com.musterbox.sdk`      |
| Godot         | 4.2     | 4.2, 4.3                                 | addon `musterbox`        |
| Unreal Engine | 5.3     | 5.3, 5.4                                 | plugin `MusterBox`       |
| Bevy          | 0.19    | 0.19                                     | `musterbox-bevy`         |
| Cocos Creator | 3.8     | 3.8                                      | `@musterbox/cocos`       |
| Defold        | 1.6.5   | 1.6.5, 1.7.x, 1.8.x                      | `musterbox-defold-1.0.0` |
| Web (JS/TS)   | ES2020  | Chromium 89+, Firefox 108+, Safari 16.4+ | `@musterbox/sdk-js`      |

## Platform / architecture support

| Platform | Architectures                   |
| -------- | ------------------------------- |
| Android  | arm64-v8a, armeabi-v7a, x86\_64 |
| iOS      | arm64, x86\_64-simulator        |
| Linux    | x86\_64, aarch64                |
| macOS    | x86\_64, aarch64                |
| Windows  | x86\_64, aarch64                |

Native FFI archives ship in `dist/native/<triple>`:
`x86_64-unknown-linux-gnu`, `x86_64-apple-darwin`, `aarch64-apple-darwin`,
`x86_64-pc-windows-msvc`, `aarch64-linux-android`, `aarch64-apple-ios`,
`x86_64-apple-ios`.

## Backend contract

* Minimum backend version: **1.0.0**
* Protocol versions: **1.0**

## Certification

The production certification suite reports **54/54 passed —
PRODUCTION READY**.

### Known limitations

* WebSocket connectivity requires a network connection and is not exercised
  by the offline certification suite.
* Unity and Godot adapter packages are verified by contract; interactive
  engine runs require on-device validation.
* Web adapters (browser JS/TS/React/Vue, Godot HTML5, Cocos web) are
  smoke-tested in Chromium via Playwright headless shell; Firefox/Safari
  import-map behavior is untested.
* Unreal adapter is verified by structural/boundary gates and contract; full
  UBT compilation and interactive runs require an Unreal Engine install.
* Defold adapter is verified by structural/boundary gates, the Lua harness,
  and contract; full compilation requires the Defold build server.
* Backend-side behaviors are validated against the protocol contract rather
  than a live server.

## Changelog

### 1.0.0 — 2026-08-03 (stable)

* Frozen C ABI contract (18 symbols, ABI 1.1.0) shared by Unity, Godot, CLI.
* Release distribution tree: native libraries for 7 targets, engine
  packages, CLI archives, docs bundle, SBOM, SHA-256 checksums,
  compatibility manifest.
* Certified JS/TS SDK (`@musterbox/sdk-js` / `@musterbox/sdk-wasm` /
  `@musterbox/sdk-ts`) with wasm runtime for web engines (browser, Godot
  HTML5, Cocos web, Unity WebGL).
* Unreal adapter, web production certification, and automated release
  pipeline.

### Post-1.0.0 certification hardening

* **ABI 1.1.0 → 1.2.0**: five new `musterbox_*` symbols (`refresh_session`,
  `get_session_status`, `purchase_request`, `purchase_verify`,
  `purchase_report`); ABI gate constants/contract updated everywhere
  (`compatibility-manifest`, Unreal, Unity, Defold FFI ABI).
* Unreal async logout/session-fresh/purchase surface with Blueprint nodes.
* Bevy adapter (`musterbox-bevy`, Bevy 0.19), Cocos adapter
  (`@musterbox/cocos`), Defold adapter (Lua, native + HTML5).
* Byte-reproducible packaging for Defold/Bevy artifacts.
* Certification suite 52 → 54; compatibility-matrix unified to the 1.2.0
  reality; docs ABI drift corrected.
* Final platform certification: **54/54 PRODUCTION READY**, full 23-symbol
  ABI surface verified on `dist/native`, SBOM regenerated (SPDX-2.3,
  390 packages), 28-file checksum set all verifying.

### 0.1.0 — 2026-07-27

* Initial workspace: 8 crates, ADRs 001–007, CLI (`version`,
  `workspace-info`), CI workflows, repository policies.

## ABI surface

The current C ABI is **1.2.0** with **23 exported symbols**. Native builds
must match on this version; the Defold adapter also checks its `1.2.0`
expectation against the loaded SDK (`check_abi_compatibility`).