PromptBattle v0.3.4

Operator guide

Referee (game master)

How to prepare and run a PromptBattle event — URLs, match flow, and live controls.

Who does what in the room

PromptBattle has no login accounts. Each role opens a URL; participants additionally enter a 5-digit PIN for their match.

Roles and screens in a PromptBattle event Referee /referee Your laptop Participant /play + PIN Helper 1 /helper/…/1 Helper 2 /helper/…/2 Public (projector) /public/{event} PINs, start match Audience view
You control flow on the referee screen; open other views from the live panel links.

Before go-live

  1. Create event — name, date, number of rounds.
  2. Setup wizard — round times and formats → tasks per match → mark setup ready.
  3. Add participants — mark who is present (absent players stay off the opening bracket).
  4. Go live — opening-round pairings are assigned from the present queue (FCFS).

Match flow (one task)

Advance each phase from the Current match card. Best-of-3 repeats prompt entry after each task win until the match is decided.

Match phases from waiting to winner Waiting Prompt entry Locked KI run Presentation Winner Confirm PINs Start entry Lock prompts Start KI Start presentation Record winner
PhaseYour actionRoom
WaitingConfirm players (✓), hand out PIN pills, reject absent players (✗)Players sign in at /play
Prompt entryStart prompt entry; timer runsPlayers write prompts; public shows saved text
Locked → KI → PresentationLock prompts → Start KI → Start presentationHelpers copy prompts; KI on external screens
PresentationAudience votes; you record winnerPublic stays on this match until winner is entered

Live control panel

Only Current and Next matches are expanded; all other bracket matches stay collapsed by round.

Referee live panel layout Quarterfinals CURRENT Match 1 · Task 1 Alex Chen ✓ PIN 48291 Jordan Lee ✓ PIN 71903 Start prompt entry NEXT Match 2 · waiting Confirm / reject when current match is locked or later Match 3 · TBD vs TBD · Waiting
Phase buttons appear on the Current card only. Prepare the Next card while the room watches KI output or votes.

Parallel overlap

While the current match is in presentation, the next match can already receive prompts — but the projector keeps showing the current match until you record the winner.

Presentation overlap between current and next match Time → Current match Presentation → record winner Next match Prompt entry (players only) Public screen Stays on current After winner: public switches to next match

Quick checklist (each match)

  1. Confirm both players; share PINs.
  2. Start prompt entry when ready.
  3. Wait for timer / both saves → Lock prompts.
  4. Start KI execution → helpers use copy boxes.
  5. Start presentation → audience votes → record winner.
  6. Prepare next match (confirm / PINs) once current prompts are locked.

Open the live views

From the referee event page, use the links in Live control:

Open referee — events Back to home