Fun and UX plan
Fri Nov 13. Owner: the director (fun and UI/UX, Don 23:37). Analysis only. "From code" means read in source, not seen on screen.
1. Fun audit
A take now (chase, Rehearsal). A debug timer sits top left. Kid runs 4 s with nothing to do, then JUMP! appears in the engine font over a shrinking ring. You press, PERFECT flashes, and c1_vault PERFECT +4 ms piles up on the left. Then 3 to 4 s of watching. It ends on five yellow squares and SCORE 92.
Unclear
- The press target is invisible. It sits at the film moment plus 216 ms, about 816 ms after the call starts, and call leads vary from 500 to 700 ms (
chase_cues.json). - The Take shows no timing at all.
NOW!is supposed to mean "hold Down".- Banners show internal names (
FLUB: VAULT_CLIP), and every wreck says "RESET THE GATE", the cannon included.
Unfair
- The Rehearsal pass edge is ±88 ms, rhythm-game tight for one-off cues.
- By my model, a centred sd 45 player should get 4.3 stars on Rehearsal/Easy; the bot gets 3. The likely causes of this hidden tax are holds graded on the worse of press and release, and keyboard double-tap flicks.
- The +216 centre fits one man on one setup.
- From code,
RumbleEffectis never assigned (KKCueGateComponent.h:59), so nothing rumbles. - From code, touch sends only Act1 and flicks (
KKCueGateComponent.cpp:378), so phones can't pass the hold-Down or Hang cues.
Dull. A hit and a miss each get one silent word. Walt says nothing between calls.
Missing: anticipation, a cue language, streaks, pause (STANDARDS requires it), subtitles in takes, settings, and reasons to replay (per-scene bests, a bloopers collection, a Director's Cut unlock).
2. Difficulty and feel
Predictable cues.
- Walt's call starts exactly one beat (600 ms) before the film moment, and you press on the next beat, like answering Space Channel 5.
- Reaction time stops mattering. Data only (
call_open_ms = t_ms - 600).
Sync the slate (first launch, about 10 s; redo from Settings)
- The AD says "Marker." The clapper claps 12 beats, and the player presses along to the last 8.
- The offset is the median press error, ignoring presses more than 150 ms out.
- Walt says "Again." if the spread tops 60 ms.
- The result replaces the fixed
CentreOffsetMs(216 if the player skips). - "Sync by picture" (sticks only) for Bluetooth headphones, like Rock Band's video step.
- After each take the offset drifts 30% toward the median pass error, capped at 30 ms.
Window targets (half widths in ms; strictness still scales ×1.3, ×1.0, ×0.8):
| Mode | Perfect | Good | Pass | Pass now |
|---|---|---|---|---|
| Rehearsal | 70 | 120 | 180 | 88 |
| The Take | 50 | 90 | 140 | 71 |
| Director's Cut | 35 | 65 | 100 | 55 |
- Windows may open before the film moment. That needs a negative
OpenFloorMs, which lifts the clamp atKKCallSheet.cpp:74. - A unit test keeps each cue's close plus late guard before its branch commits (the blend rule).
- Holds grade on the press; the release (±200 ms slack) costs one grade at most.
Assists. No star cap, but an "assist" stamp on the sheet.
- "Steady hands" widens windows ×1.5.
- "One button" turns holds and hangs into taps.
- "Stunt team" plays a missed cue as Scrappy, which is the accessibility guidelines' QTE skip.
Bot plan (tower 2, 10 seeds a cell, chase, then every scene)
- New flags:
-KKBias,-KKSyncBias,-KKBot=touch. - Mean stars, Rehearsal/Easy, Take/Book, DC/Strict:
- skilled sd 45: 5, 4, 3
- casual sd 75: 4, 3, 2
- kid sd 100: 3 (prints at least 60%), 2, 1
- uncalibrated +120 sd 60: 3, 2, 1, and casual or better after sync
- I disagree with QA's 3 stars for sd 45 on The Take: that player is Don-tight and should feel good on the middle setting. My model gives 5.0, 4.3, 3.4 (sd 45) and 4.5, 3.5, 2.2 (sd 75) before the tax; the sweep decides.
3. UI/UX by screen
Every screen
- Materials: typewriter paper for plans, the slate for takes, grease pencil on film for the edit, the cinema for the premiere.
- Minimum sizes at 1080p: body text 26 px, subtitles 46 px.
- Phones: nothing under 16 px, touch targets 48 dp, landscape with safe areas. Contrast 4.5:1 on a backing card.
- Scale is
min(W/1280, H/720)(today'sH/720overflows narrow screens). - Prompts name the device's own buttons.
Cue language. Shape carries meaning; Okabe-Ito colour backs it up.
| Input | Walt | Glyph | Colour |
|---|---|---|---|
| Jump: Space, pad A, tap | "Jump" | up chevron | #56B4E9 |
| Tuck (hold): S, pad B, press and hold | "Down" | filling bar | #D55E00 |
| Dodge: AA or DD, stick, swipe | "Left", "Right" | side arrow | #F0E442 |
| Hang: Shift, RT, two-finger hold | "Hang on" | hook | #CC79A7 |
On touch, a hold anywhere counts as the button the open cue wants.
Screens
- Call sheet
- Mimeograph paper, Courier Prime.
- A grease-pencil ring marks focus, replacing the yellow bar.
- Rubber stamps show
IN THE CAN, the best stars andBLOOPERS 4 / 15. - Settings on its back: volume per channel, subtitle size, sync, assists, reduce motion, reduce flashing, rumble.
- Sync: a chalk slate (PROD, ROLL, SCENE, TAKE, DIRECTOR, CAMERA, DATE) in Bebas Neue, with the sticks drawn on the canvas.
- Walk-through: subtitled; each glyph shows once on a corner slate when Walt first points to that move (the "word once" rule).
- Take HUD: the corners stay empty.
- Rehearsal: a small clapper at the bottom opens on the call and shuts on the beat, glyph on its face. It replaces the ring.
- The Take: subtitle only.
- Director's Cut: nothing (QA #2).
- The grade is stamped near Kid for 0.6 s.
- Hit feedback
- A sting per grade: a slate clack for Perfect, a softer one for Good, a scuff for Scrappy, a crew groan on a miss.
- Rumble by grade; a small shake and 2° FOV punch (off under reduce motion).
- A Walt bark on some cues, never every one. The pool has about 12, for example "Yes.", "Ugly. Keep going." and "Late, Kid."
- Three clean cues in a row lift the music stem. Slow motion only on a Perfect take's last stunt, if sequence audio survives it.
- Wrap
- The slate, chalked SCENE 1 TAKE 3, stamped
PRINTorNO GOOD. - Stars punched like a ticket, and the cues as graded glyphs.
- GO AGAIN and EDIT BAY as tabs.
- Menu input must not depend on cursor or focus (QA #1).
- The slate, chalked SCENE 1 TAKE 3, stamped
- Edit bay: Moviola green-grey; each attempt a three-frame strip with sprockets; a grease-pencil X on the pick; a red leader tab on wrecks; a glyph legend instead of hint lines.
- Beats: letterbox, subtitles, skip after 2 s.
- Premiere: a countdown leader (8 to 2, pop at 2) before reel 1, cue dots before reel changes, the critic's notice as a clipping.
- Credits: bloopers picture in picture; Kid's credit holds 3 s.
- Pause (Esc, Start, a corner button on touch): a card headed HOLD with Resume, Restart take, Settings, Call sheet.
Fonts. All are commercial-OK. Ship each licence file and credit each font.
| Font | Licence | Use |
|---|---|---|
| Courier Prime | OFL | body |
| Bebas Neue | OFL | slate, headings |
| Alfa Slab One | OFL | posters |
| Permanent Marker | Apache 2.0 | grease pencil |
| Atkinson Hyperlegible | OFL, verify | subtitles |
Imported as UFonts by an editor script.
Ours: unlettered textures from tower 1 (paper, clipboard, chalkboard, Moviola metal, film strip, gaffer tape) and voiced barks; all lettering is drawn in-engine. Sourced: only the fonts.
4. Tickets (about 41 h, cheapest high impact first)
| # | Ticket | h | Check |
|---|---|---|---|
| 1 | Strip debug from the take HUD (timer, ids, ms, branch names); per-cue flub and wreck lines; KKFPS log each second | 1.5 | shots in each mode; fps logged |
| 2 | Calls follow mode flags (QA #2); call words name the input | 1 | m_cut log and shots show no call |
| 3 | Rumble on, scaled by grade | 1.5 | KKRUMBLE lines; Don's pad |
| 4 | Call lead exactly 600 ms, unit test | 1 | test; sd 45 stars no worse |
| 5 | Touch plays every cue kind | 2 | touch bot passes every cue |
| 6 | Find the star tax per cue kind; release slack | 2 | model and bot within 0.3 stars |
| 7 | New windows, open floor, branch-commit test | 2.5 | bot targets, 10 seeds a cell |
| 8 | Scale min(), landscape, safe areas | 1.5 | shots at 720p, 1080p, 2400×1080, iPad; no hit box off screen |
| 9 | Sync the slate, drift, redo | 5 | -KKSyncBias=150 recovers within ±15 ms; Don plays it |
| 10 | Hit feedback, barks, streak (DONE, see status) | 4 | each grade logs sound and rumble; flash check; fps within 5% |
| 11 | Fonts | 2.5 | text heights measured on shots |
| 12 | Clapper prompt and glyphs | 3 | colour-blind sheet; Don eye-test |
| 13 | Wrap slate, menu input fix | 3 | 20 keyboard runs, no stalls |
| 14 | Pause (DONE, see status) | 2.5 | grades match a no-pause run |
| 15 | Subtitles everywhere (DONE, see status) | 2 | every voiced line logs one |
| 16 | Settings and assists | 3 | survive a restart; assist bot |
| 17 | Sheet stamps, bloopers count, DC unlock | 2 | full-loop bot |
| 18 | Moviola edit bay | 2.5 | shots; Don eye-test |
| 19 | Leader, cue dots, credit hold | 1.5 | capture; flash check |
Tickets 1 to 8 (13 h) fix what is broken or unfair with no new art. Run the bot matrix after 7 and 9; Don gets one build after 12.
Status, Fri 01:47: tickets 1 to 8 landed in 58298c3 and ca6d634 (results, the bot star table and what is left: devlog/notes.md, the section headed fun and UX tickets 1 to 8). Pass edges are 180/140/100 as planned and Perfect and Good kept the plan's widths (70/120, 50/90, 35/65); to land the bot targets (steady 5, 4, 3 stars, casual 4, 3, 2) the star points dropped to 1.0, 0.5 and 0.25.
Status, Fri 12:27: tickets 10 and 15 done (670c0ce). Hit feedback: a sound, rumble, camera punch (Perfect only) and streak per grade, Walt barks from the recorded lines on a clean run, KKFEEDBACK per grade; subtitles on every voiced line, KKSUB per line, 140 of 140 in the full loop. Results and what is left: devlog/notes.md, the section headed fun tickets 10 and 15.
Status, Fri 13:25: ticket 14 done. Esc, pad Start or the touch corner button opens a card headed HOLD (Resume, Restart take, Settings, Call sheet); the sequence player and the cue gate stop together, a press while held grades nothing, and resume re-anchors the input clock. Settings opens a stub card because ticket 16 is not built. Checks: Scripts/fun14_run.ps1 and fun14_check.py, results in devlog/notes.md (section fun14). Also in this pass: the three missing Walt barks (walt_x08 "Yes.", walt_x09 "Ugly. Keep going.", walt_x10 "Late, Kid.") and Rehearsal no longer draws Walt's subtitle under the call word it already shows.