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

# 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

```text theme={"dark"}
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`:

```bash theme={"dark"}
# 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:

```json theme={"dark"}
"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:

```bash theme={"dark"}
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](/guides/second-session-mutual-claims).