How to use the
BHB Tools

What is it?

Play to Mint is the gated entry point to Big Head Billionaires. You play the in-browser BHB Arcade game to hit a score target, which unlocks the ability to mint one of the 100 total BHB NFTs using BURG tokens.

How to mint — step by step

1. 1
   Get BURG tokensYou need 5,000,000 BURG to mint. Buy on pump.fun — CA: 6disL...pump
2. 2
   Connect your Solana walletPhantom, Solflare, or Ledger. Hit "Connect Wallet" in the nav.
3. 3
   Play BHB ArcadeReach the 30,000 point target to unlock the mint button. Your progress bar fills as you score.
4. 4
   Mint your BHBOnce unlocked, hit 🍔 MINT NOW. Costs 5,000,000 BURG + ~0.02 SOL network fee. Strictly 1 per wallet.
5. 5
   Head to the CustomizerYour freshly minted BHB NFT is now ready to personalize.

What is it?

The Customizer is a browser-based character builder. Mix and match traits across Eyes, Mouth, Head, Outfit, Texture, Body, and Backgrounds. Free to use for anyone — connect your wallet to save traits directly onto your minted NFT.

Key Features

• Trait sliders — Cycle through every available trait with ◀ ▶ arrow controls.
• Female Mode — Toggle to switch to the female character base.
• DUO Scenes NEW — Build a two-character side-by-side scene, export at 2000×1000 px.
• Slot system — Save up to 2 character builds in browser slots.
• Export PNG — Download your character as a high-res PNG instantly. No wallet needed.
• Save to NFT Wallet — Write traits on-chain to your BHB NFT. Costs 100,000 BURG.
• Load NFT Traits — Pull on-chain traits from any BHB NFT in your wallet.
• Open in Animator — Send your character directly to the Animator with one click.

Step-by-step

1. 1
   Open the CustomizerNo wallet required to design. Assets load automatically.
2. 2
   Use trait arrows to buildClick ◀ ▶ on each trait slot to cycle options. Changes preview live on the canvas.
3. 3
   Save to a slotHit 💾 SAVE SLOT 1 or SLOT 2 to persist your build in localStorage.
4. 4
   Export or save to chainDownload PNG for free, or connect wallet and pay 100k BURG to write traits to your NFT permanently.
5. 5
   Send to AnimatorClick 🎬 Open in Animator → to bring your character into the Animator with its full trait set intact.

What is it?

The Animator brings your Big Head to life. Load a character built in the Customizer, attach audio, set expressions on a timeline, and export a polished animated video. It supports solo and DUO (two-character) scenes.

Key Features

• Auto Lip Sync — Mouth shape driven automatically by audio volume. Choose Ehh or Ooo sync style.
• Manual Mouth Keyframes — Set specific shapes at exact timestamps.
• Auto Expressions — Expressions placed automatically based on audio volume & pauses. Pick a Mood Preset: 😡 Mad, 😌 Calm, 😄 Happy, 😲 Shocked.
• Eye Keyframes — Manually add blinks and expressions at any point.
• Volume Keyframes — Automate volume changes over time.
• Music Track — Layer a separate background music track with fade in/out controls.
• 88 Background Scenes — Preset scene backgrounds. Supports green screen, solid color, or image upload.
• DUO Mode NEW — Two characters, independent audio/expressions, 2000×1000 export.
• Export MP4 — H.264/AAC MP4 via WebCodecs. Internet-ready quality.

Getting started

1. 1
   Build your character in the Customizer firstThe Animator loads character data from the Customizer's saved slots. Click 🎬 Open in Animator from there.
2. 2
   Record or upload audioUse 🎤 Record to capture your voice live, or 📁 Upload a file.
3. 3
   Enable Auto Lip SyncToggle 🤖 Auto Lip Sync ON. The mouth will animate from audio volume automatically.
4. 4
   Set expressionsUse ✨ Auto Expressions with a Mood Preset for quick results, or manually place eye keyframes.
5. 5
   Pick a backgroundSelect a scene from the preset carousel, upload your own image, or use green screen.
6. 6
   Export your videoHit 🎥 Export Video. Compresses to H.264 MP4. On mobile: Share sheet or download overlay will appear.

What is it?

BHB Live is a desktop app that puts your Big Head Billionaire on screen as a live avatar during streams — similar to VTube Studio. It runs as a separate window that OBS captures. Your microphone drives real-time lip sync, hotkeys trigger eye expressions, and auto-blink fires on a timer. Works on Mac and Windows.

Key Features

• Auto Lip Sync — Mic input drives mouth shapes in real time. Mouth opens and closes with your voice automatically.
• Expression Hotkeys — Assign any key (F1–F12, letters, combos) to 8 expressions: Stare, Curious, Joy, Surprised, Stern, Infuriated, Ouchy, Blink. Keys fire globally — even when OBS is in focus.
• Auto Blink — Randomized blink on a configurable interval (1–12s). Toggle on/off.
• Background Modes — 🟩 Green Screen, 🟦 Blue Screen, ⬛ None, 🖼 Character BG layer, 🌆 88 Scene presets.
• 4 Memory Slots — Save and name up to 4 full character builds. Push any slot to live instantly.
• First-run asset download — Downloads all character assets once on first launch. Fully offline after that.

Download & Install

1. 1
   Download the installer for your OS→ BHB Live Releases on GitHub
   Download BHB-Live-Mac (contains the .dmg) or BHB-Live-Windows (contains the .exe). Unzip the download first.
2. 2
   InstallMac: Open the .dmg → drag BHB Live into Applications → right-click → Open → click Open in the security dialog (first launch only).
   Windows: Double-click the .exe → follow the installer → appears in Start Menu and Desktop.
3. 3
   First launch — one-time asset downloadBHB Live downloads all character assets (~150 MB) and saves them to your device. This only happens once. Every launch after is instant with no internet required.
4. 4
   Allow microphone access when promptedRequired for lip sync. On Mac: System Settings → Privacy & Security → Microphone → enable BHB Live if it doesn't prompt automatically.

OBS Setup

1. 1
   Build your character & GO LIVEDesign your Big Head, save to a slot, set your background mode, then click GO LIVE. The frameless canvas window opens — this is what OBS captures.
2. 2
   Add to OBSAdd Source → Window Capture → select "BHB Live — OBS Capture". Add a Chroma Key filter if using green or blue screen.
3. 3
   Assign expression hotkeysIn the right panel, click any expression's key slot and press your chosen key. Keys fire globally even when OBS is focused.

What is it?

Burn for BURG lets you exchange NFTs from the original Big Head Billionaires collections for BURG tokens. Connect your wallet, select an eligible NFT, confirm the burn, and BURG is sent to your wallet. The NFT is gone permanently — this cannot be undone.

Rewards

Eligible Collections

• Big Head Billionaires — the original collection
• Scumbag$
• Slimeball$
• Mutant Bags
• Wall Bananas

How to burn — step by step

1. 1
   Connect your walletHit Connect Wallet. The page will automatically load any eligible NFTs from the supported collections.
2. 2
   Select an NFT to burnYour eligible NFTs will appear. Click the one you want to exchange. Your reward amount will be shown before you confirm.
3. 3
   Confirm the burnReview the warning — this is permanent and irreversible. Click 🔥 BURN & CLAIM REWARD and approve the transaction.
4. 4
   Receive your BURGOnce the transaction confirms, BURG tokens are sent to your wallet. The NFT cannot be recovered.

What is $BURG?

BURG is the SPL token that powers the BHB ecosystem. You need it to mint an NFT, save traits on-chain in the Customizer, and it's what you earn from burning. It lives on Solana and can be bought or swapped on any Solana DEX.

Contract Address

Where to buy

• pump.fun — where BURG launched. Paste the CA to find it directly. → Open on pump.fun
• Jupiter (jup.ag) — best rates on Solana. → Swap on Jupiter
• Raydium — another popular Solana DEX. → Swap on Raydium

Buying on mobile

1. 1
   Open Solflare app → tap BrowserSolflare has a built-in browser. Recommended over Phantom for full functionality during the active mint.
2. 2
   Navigate to jup.ag or pump.funBoth work inside Solflare's browser. Jupiter generally gives the best swap rates.
3. 3
   Paste the CA into the swap fieldSearch for BURG by pasting: 6disL...pump. This ensures you're buying the correct token.
4. 4
   Swap SOL → BURG and confirmFor minting you need 5,000,000 BURG. Approve the transaction inside Solflare.

What is it?

AI agents (such as OpenClaw bots on MoltBook) can drive the full BHB character creation pipeline autonomously — building a character, generating a voice with ElevenLabs, animating it with lip sync, and exporting a finished MP4.

Requirements

Agent Session API

POST your character traits and receive pre-seeded Customizer and Animator URLs — traits load automatically on open.

{
  "traits": {
    "BODY": "Dark Tone",
    "HEAD": "Outlaw",
    "EYES": "Grumpy",
    "MOUTH": "Mmm",
    "OUTFIT": "Trenches",
    "TEXTURE": "None",
    "BACKGROUND": "Graphite"
  },
  "female": false,
  "slot": 1
}

{
  "customizerUrl": "https://bigheadbillionaires.com/customizer/?agent=eyJ...&slot=1",
  "animatorUrl":   "https://bigheadbillionaires.com/animator/?agent=eyJ...&slot=1",
  "indices": { "BODY": 11, "HEAD": 39, "EYES": 6, ... },
  "slot": 1
}

Pipeline — 4 stages

1. 1
   Customizer — Build the character (browser)Use the Agent Session API to get a pre-seeded Customizer URL, or manually cycle trait slots.
2. 2
   ElevenLabs — Generate voice audio (API callable)Call the ElevenLabs TTS API. Recommended: Stability 0.40–0.55, Similarity Boost 0.75.
3. 3
   Animator — Assemble and animate (browser — 2 clicks)Open the pre-seeded animatorUrl — traits, Auto Expressions, and mood preset load automatically. Upload the .mp3 — lip sync fires automatically. Click Export.
4. 4
   Export — H.264 MP4 outputThe Animator encodes in-browser via WebCodecs (H.264 + AAC). No server upload.

Soul files & character schema

The repo includes a soul file format — structured JSON character definitions that specify traits, voice parameters, expression maps, and dialogue prompt prefixes. Start with example-char.json and reference gravel-pete.json as a completed example.