SDK overview

The MusterBox SDK surface — one Rust core, many packaging targets.

The MusterBox SDK is a Rust core library (version 1.0.0) that is packaged for every supported engine and the browser. Its job is to be a reliable, secure bridge between your game and the MusterBox backend — never a source of authority.

What the SDK does

• Configures and validates your integration (config schema 1) before any traffic leaves the device.
• Manages the session lifecycle: initialize → start → authenticate → refresh → logout → shutdown.
• Flushes events in batches over the event plane with offline buffering.
• Polls realtime events — session, wallet, and status events.
• Drives secure purchases through PurchaseClient with an on-device environment-integrity pre-flight.
• Reports diagnostics and environment health.

Public surfaces by language

Surface	Entry point	Notes
Rust	MusterBoxSdk	Native core, blocking + async
C ABI	musterbox_ffi.h (ABI 1.2.0)	23 exported symbols, memory rules
WebAssembly	@musterbox/sdk-wasm	Compiled core for the browser
TypeScript/JS	@musterbox/sdk-js	camelCase wrapper over sdk-wasm
Godot	musterbox-godot	GDExtension, NativeScript API
Unity	MusterBox C# wrapper	MusterBoxSdk.Instance singleton
Bevy	Rust plugin	Same crate family as the core
Unreal	MusterBox plugin	Blueprint/C++ module
Cocos/Defold	TypeScript / Lua bindings	See engine pages

Core concepts used everywhere

• Config — validated MusterBoxConfig; invalid config fails fast with InvalidConfig before networking begins.
• Runtime options — Manual (you call tick) or Threaded (background worker) with a TickBudget.
• Status — an explicit lifecycle machine you can observe via get_status.
• Errors — SdkError with stable SdkErrorCodes (MBX-SDK-001 … 013).

Start here

• Installation
• Configuration
• Initialization & lifecycle
• Authentication
• Sessions
• Events & realtime
• Secure purchases
• Security & integrity
• Errors
• CLI