> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3.fun/llms.txt
> Use this file to discover all available pages before exploring further.
# Game Launcher
> Launch games natively inside the BSMNT (basement.fun) platform and build addicting onchain experiences without having to worry about the crypto components
## How It Works
Your game loads inside BSMNT launcher. We pass a JWT with the auth token to your game.
```text Example URL theme={null}
https://yourgame.com?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```
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.
```json Player Profile theme={null}
{
"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..."
}
```
Let the user play your game. When something happens, you can trigger an action via our Zapier-style rules engine, or directly via API.
```bash Trigger API Example theme={null}
curl --location 'https://api.basement.fun/launcher/' \
--header 'X-Service-Method: triggerRulesEngine' \
--data '{
"launcherJwt": "{{ jwt }}",
"trigger": "achievementUnlocked",
"nonce": "d1312e"
}'
```
Get started building games with BSMNT launcher
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
Store player state on decentralized storage options like IPFS.
Let users mint NFTs upon achievements or on certain game events.
Bring player rankings onchain, host contests & tournaments.
Send ERC20s and ERC721 & 1155 NFTs based on game actions.
Prompt users to send or transfer tokens to pay for in-game actions or assets.
### Coming Soon
Users can use assets from other chains to swap for your tokens.
COMING SOON
Direct fiat to crypto onramp for seamless user experience.
COMING SOON
Built-in review and rating system for games.
COMING SOON
Social sharing and viral mechanics.
COMING SOON
Automatic gameplay recording and sharing.
COMING SOON
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.
Sign up to start integrating your game with BSMNT launcher
Already registered?
Test your integration in a sandbox environment
Complete API documentation and examples
No vaporware here - play Games on BSMNT today!
No vaporware - play today!
## 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)
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.
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
Complete API reference for all available launcher features
## Architecture Overview