Dev Kit
Everything you need to build and distribute Crash BASIC games
Crash Player Downloads
Download Crash Player for your platform to play and test Crash BASIC games locally. v1.5.0
Mobile Apps
Play Crash BASIC games on your mobile device.
Google Play
Coming SoonApp Store
Coming SoonDistributing Your Games
Follow these steps to distribute your Crash BASIC games outside the Arcade.
Step 1: Choose Your License Tier
Your license tier determines your distribution rights:
- Free - Share games on the Arcade only
- Indie - License to sell games commercially (skippable splash screen)
- Studio - Full commercial rights (removable splash screen)
Step 2: Install Node.js
The packaging tool requires Node.js. Download and install it from nodejs.org (LTS version recommended).
Verify installation by opening a terminal and running: node --version
Step 3: Run the Packager
Open a terminal in the folder containing your .crashcart file and run:
npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game"
This will stamp your CrashCart with your license, download CrashPlayer, and create a ready-to-distribute package for your current platform.
Want to test before packaging?
You can stamp your CrashCart separately and test it with CrashPlayer before creating a distribution package:
npx @crashcontinuum/crashcart-stamp mygame.crashcart
This creates mygame.stamped.crashcart which you can test with CrashPlayer. Then use --skip-stamp when packaging.
Packaging Options
| -i, --icon <path> | Add a custom icon (PNG recommended) |
| -p, --platform <name> | Target platform: windows, macos, or linux |
| --all | Build for all platforms at once |
| -o, --output <dir> | Output directory (default: current folder) |
| --skip-stamp | Skip stamping (if already stamped) |
CrashPlayer Options
| --window-size <WxH> | Set window size (e.g., 800x600) |
| -f, --fullscreen | Start in fullscreen mode |
| -d, --debug | Enable debug mode |
| --no-escape-exit | Disable ESC key to exit |
Examples
# Package for your current platform npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" # Package with a custom icon npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" --icon icon.png # Build for all platforms npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" --all # Build for Windows from any platform npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" --platform windows # Start in fullscreen mode npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" --fullscreen
macOS Code Signing
For your macOS app to run without security warnings, you need to sign and notarize it with Apple Developer credentials. If you don't provide credentials, the packager will create an unsigned app and show setup instructions.
# Set credentials via environment variables export APPLE_TEAM_ID="YOUR_TEAM_ID" export APPLE_SIGNING_IDENTITY="Developer ID Application: Your Name (TEAM_ID)" export APPLE_ID="your@email.com" export APPLE_PASSWORD="xxxx-xxxx-xxxx-xxxx" # Then run the packager as usual npx @crashcontinuum/crashcart-packager mygame.crashcart "My Game" --platform macos
Requires: Apple Developer Program membership ($99/year)
Mobile (Studio tier)
Coming soon
Step 4: Distribute
Your game is now packaged and ready to share:
- Windows - Zip the output folder and share
- macOS - Distribute the .app bundle directly or zip it
- Linux - Zip or tar the output folder
- Web - Share a link to your game on the Arcade