@crashcontinuum/crashcart-stamp

License stamping tool for CrashCart game bundles.

Stamps your .crashcart files with a license from Crash BASIC Arcade, embedding your subscription tier and commercial use rights directly into the game.

Installation

# Use directly with npx (no install required)
npx @crashcontinuum/crashcart-stamp mygame.crashcart

# Or install globally
npm install -g @crashcontinuum/crashcart-stamp
crashcart-stamp mygame.crashcart

Usage

crashcart-stamp <crashcart-file> [options]

Options

| Option | Description | |--------|-------------| | -o, --output <file> | Output file path (default: <input>.stamped.crashcart) | | --arcade-url <url> | Arcade base URL (default: https://arcade.crashbasic.com) | | -h, --help | Show help message | | -v, --version | Show version number |

Examples

# Stamp a crashcart (creates mygame.stamped.crashcart)
npx @crashcontinuum/crashcart-stamp mygame.crashcart

# Stamp with custom output filename
npx @crashcontinuum/crashcart-stamp mygame.crashcart -o mygame-licensed.crashcart

# Use a local development server
npx @crashcontinuum/crashcart-stamp mygame.crashcart --arcade-url http://localhost:3000

How It Works

1. Reads your CrashCart file and computes its SHA-256 checksum
2. Opens your browser for authentication with Crash BASIC Arcade
3. Fetches a signed license stamp from the Arcade API
4. Creates a stamped copy of your CrashCart (original file unchanged)

The stamp is cryptographically signed and bound to your specific build via the checksum. Any modifications to the CrashCart will invalidate the stamp.

Note: The original file is never modified. A new .stamped.crashcart file is created.

License Tiers

| Tier | Commercial Use | Splash Screen | Subscription | |------|----------------|---------------|--------------| | Free | No | 3 seconds, required | Free | | Indie | Yes | 2 seconds, skippable | Premium ($4.99/mo) | | Studio | Yes | Removable | Multiplayer ($9.99/mo) |

Upgrade your license at: https://arcade.crashbasic.com/pricing

Stamped File Format

The stamp is appended to the end of the CrashCart file:

[Original CrashCart Data]
[CRSTAMP\0 magic - 8 bytes]
[Stamp length - 4 bytes uint32 LE]
[JSON stamp data]

The original CrashCart content is not modified, ensuring the stamp can be verified by computing:

checksum = SHA256(file[0:metadataOffset + metadataLength + 64])

Requirements

• Node.js 18.0.0 or later
• A Crash BASIC Arcade account (free or paid)

License

© 2026 Crash Continuum LLC. All rights reserved.