UX flow · killerbufo.com

KILLERBUFO

Ten players, one screen, everybody's phone. This walks through what each person sees from the moment the screen goes up to the moment somebody wins, and what the phone is actually sending.

The loop

Nobody installs anything to play. The screen mints a code, the phones join it, and the room runs the match. Between rounds everyone keeps their seat.

BIG SCREENHost a game

▶

BIG SCREENCode + QR

▶

PHONEScan or type

▶

PHONEName, pond, ready

▶

VIP PHONEStart

▶

EVERYONEMatch

▶

EVERYONEResults, again

Getting in

Landing page — BIG SCREEN One button. It mints a four letter code and redirects to the host screen. The code box underneath is for anyone who wandered to the site on a phone.

Lobby with room code and QR — BIG SCREEN Everyone gets a bufo from bufo.fun, tinted to their pond, so a name on a TV has a face next to it. The code is the biggest thing in the room. The QR goes straight to `/p/CODE` so nobody types anything. Ponds fill in live, and the line under the logo says exactly what is still missing.

Codes avoid I, O, 0 and 1. They get read off a television by someone holding a drink.

Phone lobby controls — PHONE Name, then three decisions: which pond, whether you want to be queen, and ready. First phone in gets VIP and the start button.

What the phone decides

Control	Rule
Switch pond	Blocked when the other pond already has five.
Claim queen	One per pond. Taken means the button does nothing.
Ready	Everyone connected has to be ready before start lights up.
Start	VIP only. Appears on their phone the moment the room qualifies.

If nobody claims queen, the room hands it to whoever joined that pond first. A round never waits on a decision nobody wants to make.

The controller is landscape

Thumbs on the outside, status in the middle, nothing to reach across. Three buttons do everything; the fourth only matters when you are holding something.

Landscape controller on a phone — PHONE The real thing at 844×390. Entering a match asks for full screen and locks landscape where the browser allows it.

Turn your phone card — PHONE Held portrait when the match starts, you get this once. Rotation locked? Dismiss it and the controls stack instead.

Everything else is contextual

You do this	And this happens
Walk into a fly swarm	You pick up one fly. Only tadpoles and speedies can.
Walk into your own pond	The fly goes in. Twelve wins the round.
Walk through a gate	Warrior up in the canopy, speedy down low. The gate goes cold for a moment.
Lean on the snail	A third of a second later you are riding it. Queens cannot.
Touch an enemy	Armed beats unarmed. Two armed toads: the higher one wins.

There is no grab button and no attack button, which is the point. Two arrows and a hop is the whole thing you have to explain to somebody who just walked in.

The match

Countdown on the big screen — BIG SCREEN Three seconds where nothing moves and everyone finds their own name.

A live match — BIG SCREEN Names ride above heads. Ponds fill with water at the bottom corners. The HUD carries both tallies, both queens' remaining lives, and the clock. Big events get a banner in the pond's colour.

Results board — BIG SCREEN How it was won, then flies, kills and deaths per toad. VIP hits play again and everyone keeps their seat.

The cast

Sprites at six times size — The in-match cast, which is drawn rather than borrowed: tadpole, speedy, warrior, queen, both ponds, plus the snail, a fly and the two gates. Every pixel is a filled rectangle drawn at run time, so a promotion is four pixels of difference.

Role	Moves	Carries	Kills	Rides	How you get it
Tadpole	Hops	Yes	No	Yes	What you spawn as
Speedy	Hops, fast	Yes	No	Yes	Speed gate, low on the map
Warrior	Flies	No	Yes	Yes	Warrior gate, up in the canopy
Queen	Flies	No	Yes	No	Claimed in the lobby. One per pond.

Dying costs two seconds and your promotion: a warrior comes back a tadpole. A queen comes back a queen, and her pond loses one of three lives.

Three ways to win

Pond full

Carry twelve flies home. The slow, honest one. Swarms refill, so it never deadlocks.

Royal

Eat the rival queen three times. Fastest when one side has two warriors in the air and the other does not.

Snail

Ride the snail to your lily pad. Takes about twenty uninterrupted seconds, which nobody ever gets.

All three are live at once, which is the thing the arcade cabinet got right: a pond losing on flies can still be two kills from a takeover, so nobody can read the score and give up.

What actually goes over the wire

One Durable Object per room code. The phone sends button state and nothing else, so a tampered controller can make its own toad walk and that is the end of its powers.

Case	What happens
Phone locks or drops wifi	Token in local storage puts you back on the same toad. Your toad just stands there meanwhile.
Somebody joins mid-match	They sit the round out and play the next one.
Everyone closes their tab	The room drops the match on the next tick. The alarm sweeps the object after half an hour.
Eleventh player	Turned away with a line about ten being the cap.

Putting it on a phone

Optional. The controller is a web page and works in any browser; installing hides the address bar, holds landscape, and keeps the screen awake more reliably. Same WebSocket either way.

IPHONE AND IPAD

Safari only. Chrome on iOS cannot install one.

Open killerbufo.com in Safari.
Tap Share, the square with the arrow in the bottom bar.
Scroll down, tap Add to Home Screen.
Tap Add.
Open it from the home screen and join as usual.

iOS will not lock the orientation for you, so the turn your phone card does that job.

ANDROID

Chrome, Edge, Samsung Internet.

Open killerbufo.com in Chrome.
Tap INSTALL ON THIS PHONE if the button is showing, and you are done.
Otherwise tap the three dots, top right.
Tap Add to Home screen, then Install.
Launch it. Full screen, landscape, no tab bar.

Android honours the manifest, so it opens straight into landscape and full screen.