Skip to main content

​
How It Works

Load

Your game loads inside BSMNT launcher. We pass a JWT with the auth token to your game.
Example URL
https://yourgame.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Auth

You can load the player’s profile by decoding the JWT, or by using our API. We’ll take care of wallet connections, verification & onboarding.
Player Profile
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "username": "CryptoGamer42",
  "avatar": "https://avatars.b3.fun/avatar.png",
  "gameId": "game-123456-abcdef",
  "license": "550e8400-e29b-41d4-a716-446655440000",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Trigger

Let the user play your game. When something happens, you can trigger an action via our Zapier-style rules engine, or directly via API.
Trigger API Example
curl --location 'https://api.basement.fun/launcher/' \
--header 'X-Service-Method: triggerRulesEngine' \
--data '{
    "launcherJwt": "{{ jwt }}",
    "trigger": "achievementUnlocked",
    "nonce": "d1312e"
}'

Register as Developer

Get started building games with BSMNT launcher

Launcher Playground

Test the launcher integration in a sandbox environment

​
What can you do with BSMNT launcher?

The real power of the game launcher is in the crypto UX abstraction. Your game can securely send onchain events through a simple REST API, executable client side.

​
Available Now

Save state to IPFS

Store player state on decentralized storage options like IPFS.

Buy NFTs & Mint

Let users mint NFTs upon achievements or on certain game events.

Onchain Leaderboards

Bring player rankings onchain, host contests & tournaments.

Issue Tokens & NFTs

Send ERC20s and ERC721 & 1155 NFTs based on game actions.

Pay with Tokens

Prompt users to send or transfer tokens to pay for in-game actions or assets.

​
Coming Soon

Swap & Trade

Users can use assets from other chains to swap for your tokens.
COMING SOON

Credit Card Onramp

Direct fiat to crypto onramp for seamless user experience.
COMING SOON

Collect Reviews

Built-in review and rating system for games.
COMING SOON

Share your Game

Social sharing and viral mechanics.
COMING SOON

Record Gameplay

Automatic gameplay recording and sharing.
COMING SOON

List NFTs

Marketplace integration for trading game assets.
COMING SOON
And more actions coming - the future looks bright!

​
Getting Started

We’d love to have your game on basement.fun! It’s simple, free, and easy to start integrating.

​
What is Basement.fun?

Basement is the place to discover & play onchain games. Aside from being a discovery platform for finding great onchain games, Basement offers a way for game developers to build seamless, native, and embedded experiences within Basement. Your game is loaded inside our game launcher, where users connect to Basement, and their player context is passed down to your game. From there, you can leverage any of our generic helper functions (such as saving state & scores) + trigger any number of built-in crypto UX (without you having to integrate anything onchain in your game).

​
Access Player Data

The game launcher uses a JWT (JSON Web Token) to securely encode a verified & authenticated player context, which is sent to your game. The payload is read from the GET parameters, so any hosted web game can easily access & decode it using any number of JWT libraries (or using our launcher APIs).

​
Basic Player Data Includes:

Username (and compatible .b3.fun ENS resolvable address)
3D Avatar (.GLB model powered by ReadyPlayerMe)
Verified wallet address for onchain interactions
Game-specific player data, session information, and more - see our Launcher API Docs
You can optionally store any arbitrary game-specific player data using our player state APIs.

Explore Launcher APIs

Complete documentation for player data access and game integration

​
Built-in UX Abstraction

Our minimal game launcher experience means that the focus stays on your game. A number of customizations are available on the game launcher, so that BSMNT can provide an almost invisible experience, handling all of the core crypto UX challenges for you.

​
Helpful APIs Available:

  • Store & retrieve scores & leaderboards - Persistent game state management
  • Send notifications - Alert players about game events
  • Log and stream game activity - Analytics and player behavior tracking
  • Store player state and game sessions - Save game progress automatically
  • And more coming! - New features added regularly

Explore Launcher APIs

Complete API reference for all available launcher features

​
Architecture Overview

Connected: 0x..123
Your game loads inside BSMNT launcher

Game Launcher Integration Flow

⌘I