Boblets Boblets v1.0 · docs Enter world
DOCUMENTATION

How to play Boblets

Everything you need to know — from your first walk in the world to optimizing yield strategy across multiple houses.

Intro

Boblets is a live pixel-art world where 10 pump.fun communities ("houses") compete for vault yield. The whole point: real coordination > spam. Skill-based minigames replace farming bots. Every contribution stacks toward your house's share of a vault that distributes every 3 hours.

TL;DR — Pick a house. Walk to its billboard. Press E. Play 3 stages of a minigame. Your score becomes a contribution to your house's yield. Vault distributes every 3h, 50% goes to qualifying $BOBLETS holders pro-rata.

Your first 5 minutes

  1. Press START from the splash. Or hit ENTER AS GUEST to play without a wallet — guests boost a random eligible house.
  2. Walk using W A S D or arrows. Touch joystick on mobile.
  3. Find a totem in any of the 10 districts. Press E to inspect or claim a house.
  4. Walk to your billboard (the big poster next to the totem). Press E.
  5. Pick a game and difficulty. Play 3 stages. Your final score becomes your house contribution.
  6. Wait the cooldown (1-2 hours), then go again. Or visit other houses to coordinate, watch events, etc.

Controls

ActionDesktopMobile
MoveW A S D or arrowsJoystick (bottom-left)
InteractEE button
ChatTT button
SprintActive during Raid HourActive during Raid Hour
DashboardDASH button on topbarDASH button on topbar
Help? HELP button? HELP button
Mute♪ button♪ button

Houses & joining

10 launch houses, each a real pump.fun community. To join a house, walk to its totem and press E. You need to hold the house's token in your connected wallet to claim membership. Without a wallet, "guest" mode randomly assigns your contributions to an eligible house.

Each house has its own plaza, citizens (NPCs), color theme, and chat phrases. Houses can be challenged for the next launch wave through Town Meeting votes.

Minigames

5 games at launch, each with 10 progressive stages:

Rhythm RushGuitar-hero falling notes. Hit D/F/J/K on time.
Memory MintSimon-says pattern recall. Each round adds a step.
Quick TapReaction speed. Tap targets as fast as they pop.
Pattern MatchMemory cards. Match symbol pairs before time runs out.
Stack TowerStack moving blocks. One slip and the run ends.

Each stage gets harder — faster spawns, shorter timers, more elements. Score per stage is 0-100. Total contribution is the average × difficulty multiplier.

Difficulty & cooldowns

DifficultyMax yield / stageCooldownBest for
EASY+2%1 hourFrequent contributors, casual sessions
MEDIUM+4%1.5 hoursMost players — balanced effort vs reward
HARD+6%2 hoursSkilled players hunting max house yield
Math — Your contribution = avg stage score (0-1) × difficulty multiplier. Easy caps at +2 yield, medium +4, hard +6 per session. Yield is a weight, not a fraction of the vault — the settler normalizes every house's total at epoch close.

House yield

Yield is your house's accumulated contribution score within the current epoch. When the epoch ends (every 3 hours), houses with higher yield get a bigger share of the vault distribution.

It's a team effort. Every member's contribution stacks. A house of 100 active players doing easy daily plays beats 5 hard-mode whales every time.

The vault

The central vault is the developer wallet on Solana that the $BOBLETS token launches through. Token holdings (the $BOBLETS token plus all 10 house tokens) live there.

The frontend cannot withdraw — only read. All distributions happen via on-chain settlement. See Security for the full guarantee.

Vault address:

3-hour epochs

Every 3 hours, the vault distributes 50% of its current USD value to qualifying holders. Epoch boundaries are anchored to a fixed launch timestamp — all clients see the same countdown.

  • Epoch length: 3 hours
  • Distribution: 50% of vault USD
  • Qualifying floor: 50,000 $BOBLETS held
  • Per-wallet split: pro-rata × tier multiplier

Tier ladder

TierHoldMultiplierUnlocks
SHRIMP0+1.00×Walk, watch, no airdrop weight
FISH50K1.08×Qualifies for airdrop
DOLPHIN500K1.18×Citizen Bounty unlocked
SHARK5M1.30×Raids unlocked
WHALE50M1.50×Treasury Tribute, max yield bonus

Airdrop math

At each epoch close:

distribution = vault_usd × 0.50
qualifying_holders = wallets with ≥ 50K $BOBLETS
weight = balance × tier_multiplier
share = (your_weight / total_weight) × distribution

House yield doesn't change the airdrop directly — it changes which houses contribute most to the next epoch's vault. The vault grows, and your $BOBLETS holding gets you a slice every 3 hours.

World events

Random events fire across the world. They modify contribution multipliers in real time:

EventMultiplierBehavior
Solar Eclipse2.0×All contributions doubled
Raid Hour1.5×NPCs sprint to vault, faster movement
House Spotlight3.0×One random house gets triple yield
Whale VisitWhale crosses the world, walk under for vault tip
Earthquake0.5×Camera shakes, NPCs panic, contributions halved
Locust Swarm0.7×Treasury rate halved
Lightning Storm0.6×Random house progress freezes
House Fire0.3×House yield bleeds until citizens douse it (E at burning billboard)

Raids

SHARK+ tier players can raid rival houses. Walk to a rival billboard, press E, RAID. Steals 3-12% of their vault into yours.

  • Cooldown: 12 minutes per raider
  • Split: 85% to attacker's house vault, 10% to attacker's personal share, 5% to PT treasury
  • Raids are visible in chat and trigger a defense window for the target

Disasters

Disasters hit random houses. Citizens have to organize to mitigate them:

  • Fire — Run to the burning billboard, press E to bucket-brigade. Multiple players speed up extinguish.
  • Earthquake — Vault accrual halts. Wait it out or coordinate.
  • Lightning — Random house progress freezes. Strategic raids become attractive.
  • Locusts — Treasury rate halves. Affects PROTOCOL category tasks most.

Town meeting

New houses join through community vote. Open MEETING on the topbar, paste a CA, cast your vote. One vote per hardware-id. Top voted houses get promoted to the next launch wave.

Multiplayer

Boblets is multiplayer-first. The current build uses BroadcastChannel for cross-tab presence (open two tabs and they see each other). Production routes everything through a WebSocket server so all players in the world see each other walking, contributing, raiding, and chatting in real time.

Server-side validation enforces minigame minimum-time anti-cheat and contribution rate limits.

Security

  • Founder-controlled vault — the wallet is a multisig the founder controls. The client never holds private keys.
  • Read-only frontend — no withdraw paths exist in the client. All distributions are signed on-chain.
  • Hardware-id voting — town meeting votes are gated by hardware id, not wallets, to make sybils more expensive.
  • Anti-cheat minigame timing — sessions shorter than the minimum play time are rejected.

FAQ

Do I need a wallet to play?

No. Guest mode lets you play without a wallet — your contributions just go to a random eligible house. Connect Phantom to claim a specific house and qualify for airdrop tiers.

What if I lose connection mid-minigame?

The session is rejected — score is 0. The cooldown timer doesn't start until a session completes successfully.

Can multiple people play for the same house?

Yes — that's the point. Every member's contribution stacks on the same house yield. Coordinate, time your plays around events, optimize together.

How do I climb tiers?

Hold more $BOBLETS. Tiers are read live from your wallet balance. Higher tier = bigger contribution multiplier and bigger airdrop weight.

What happens if my house has a fire?

Run to the burning billboard and press E to extinguish. Multiple players speeds it up. Until extinguished, your house only earns 30% of contributions.