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