Godot

Integrate the MusterBox SDK with Godot 4.2+ via the GDExtension.

The Godot adapter (musterbox-godot, addon musterbox) is a GDExtension implemented in Rust. Min Godot version 4.2.

Install

Copy the packaged addon into your project and enable it in Project > Project Settings > Plugins:

# extract dist/godot/musterbox-godot-1.0.0.zip into your Godot project

The extension builds for desktop (macOS, Linux, Windows), Android, and iOS.

Initialize

var config = MusterBoxConfig.new()
config.game_id = "my-arena-game"
config.game_key = "gk_..."
config.environment = "sandbox"
config.offline_buffering = true

var sdk = MusterBoxSdk.new()
sdk.initialize(config)
sdk.start()

Authenticate and open a session

sdk.authenticate("[e-mail]", "secret")
var ctx = sdk.open_session("sandbox", 1042)
# ctx.session_id, ctx.token, ctx.expires_at, ctx.context...

Events and updates

sdk.submit_event("match.start", { "mode": "arena" })
var updates = sdk.poll_wallet_updates(64)
for u in updates:
    print(u)

Threaded purchase bridge

The Godot adapter drives PIN mint/verify from std::thread workers. The PurchaseClient blocking variants are expressly designed to be safe from engine worker threads:

var preflight = sdk.purchase_mint_pin_session("item-arena-bundle", 9.99, "purchase-1")
if preflight.kind == "Ready":
    var session = preflight.session
    var outcome = sdk.purchase_verify_pin(session.session_id, session.session_token, pin, verify)

Blocking variants must not be called from inside another async runtime context (e.g. a Tokio worker in a Rust plugin).

Support matrix

Godot	SDK	Targets
4.2+	1.0.0	Desktop (macOS/Linux/Windows), Android, iOS

Next: Unreal Engine.