Player journey¶
From the player's point of view, the whole system boils down to one card.
journey
title A player's day at the Retroverse Tetris tournament
section Registration
Walk up to the terminal: 4: Player
Enter nickname and details: 4: Player
Card is written and verified: 5: Player
section Playing
Tap card at a station: 5: Player
Reader shows rank and best score: 5: Player
Play — live on the hall screen: 5: Player, Audience
Game counted automatically: 5: Player, Crew
section Afterwards
Check rank at the terminal: 5: Player
Watch the replay: 4: Player
Qualify for the bracket: 5: Player, Crew
1 · Register at the terminal¶
sequenceDiagram
autonumber
actor P as Player
participant T as Terminal
participant R as Reader
participant L as NestrisLTM
P->>T: taps "Neu anmelden"
T->>L: GET /nickname?value=Erv
L-->>T: free
P->>T: nickname, name, e-mail (+ consent)
T-->>P: "Karte auflegen"
P->>R: places blank card
R-->>T: card present (uid)
T->>L: POST /players (with card uid)
L-->>T: player created, card linked
T->>R: write name="Erv"
R->>R: write · read back · verify CRC
R-->>T: result ok
T-->>P: "Karte bitte entnehmen" ✓
- Only the nickname is ever shown publicly. Name and e-mail are only for the organisers; the e-mail address needs explicit consent.
- The card's UID is the player's identity. The name on the card is a convenience for displays.
- Lost a card? The crew can link a new card to the same player in the admin UI, and a player can have several cards.
2 · Play at a station¶
- Put the card on the station's reader. The OLED greets you with your nickname, rank and best score of the current event.
- Play. The station recognises the game by itself, with no button to press.
- Leave the card on the reader while you play. If you remove it, the station keeps the player for a short grace period. The next player's card takes over.
- When the game ends, the score is counted automatically. If it is your new best, the hall display celebrates it.
Fair play
Every game is recorded frame by frame. The Select score trick (+10 000) is detected and flagged. Suspicious games are reviewed by the crew using the recording.
3 · Check your stats¶
Put your card on the terminal's reader to open your player page:
- all-time statistics and history per event
- current event: rank, best score, gap to the next place
- every game, with a replay button (0.25×–8×, scrubbing, frame steps)
- "Score eintragen" for a score from a console without a station. It counts at once and is marked as self-reported for the crew to check.
Remove the card and the page closes after 3 seconds.
4 · Qualify and compete¶
The highscore of the active event decides the seeding. The best players advance to the single-elimination bracket, which is played in versus matches on stream with live score difference and "needs N tetrises".