Package & install

Vendor, verify, and install the MusterBox SDK for your target.

The SDK is shipped as local packaged artifacts for all targets. This guide covers the repeatable install flow.

Artifact layout

dist/
├── unity/       musterbox-unity-1.0.0.tgz
├── godot/       musterbox-godot-1.0.0.zip
├── unreal/      musterbox-unreal-1.0.0.zip
├── bevy/        musterbox-bevy-1.0.0.tar.gz
├── cocos/       musterbox-cocos-1.0.0.tgz
├── defold/      musterbox-defold-1.0.0.zip
├── javascript/  musterbox-sdk-js-1.0.0.tgz
│                musterbox-sdk-ts-1.0.0.tgz
│                musterbox-sdk-wasm-1.0.0.tgz
├── cli/         musterbox-cli-1.0.0-<triple>.tar.gz
├── native/      <triple>/libmusterbox_ffi.{a,dylib,so,dll}
├── manifests/   compatibility-manifest.json, sbom.spdx.json
└── checksums/   SHA256SUMS

Verify integrity

Every artifact is covered by dist/manifests/compatibility-manifest.json (artifact hashes) and dist/checksums/SHA256SUMS:

# from the repo root
shasum -a 256 -c dist/checksums/SHA256SUMS

The manifest also pins the exact supported engines and platforms — compare it against your build before releasing:

"supported_engines": {
  "unity": { "min_version": "2020.3", "package_name": "com.musterbox.sdk" },
  "godot": { "min_version": "4.2",  "addon_name": "musterbox" },
  "js":    { "min_version": "ES2020", "package_name": "@musterbox/sdk-js" },
  "cocos": { "min_version": "3.8",  "package_name": "@musterbox/cocos" },
  "bevy":  { "min_version": "0.19", "crate_name": "musterbox-bevy" },
  "unreal":{ "min_version": "5.3",  "plugin_name": "MusterBox" },
  "defold":{ "min_version": "1.6.5", "extension_name": "musterbox", "ffi_abi_version": "1.2.0" }
}

Native platforms: 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.

Vendor the artifact

Do not rely on a friend’s node_modules — vendor:

• npm-style targets: commit the tarball and use a file: dependency ("@musterbox/sdk-js": "file:vendor/musterbox-sdk-js-1.0.0.tgz").
• Rust/Bevy: point Cargo.toml at the extracted crate (musterbox-bevy = { path = "vendor/musterbox-bevy" }).
• Native FFI: link the libmusterbox_ffi archive for your triple and verify ABI 1.2.0 at link time.

Verify at runtime

After installing, confirm:

musterbox sdk version       # SDK 1.0.0, protocol 1.0, ABI 1.2.0
musterbox config validate   # existing profile is valid
musterbox sdk smoke-test    # full local lifecycle

A mismatch (wrong ABI/config schema) fails fast with MismatchedVersion instead of a confusing runtime error.

Next: Mutual-claim result flow.