Open the books

RAW FILE: FUN-UX-PLAN.md (Kid Katapult)

Source game/FUN-UX-PLAN.md in the jam repo. Last git commit of this file: 2026-11-13. About 1,993 words. Scrubbed only for private details and one line about another entrant. Mistakes left in on purpose.

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

Unfair

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.

Sync the slate (first launch, about 10 s; redo from Settings)

Window targets (half widths in ms; strictness still scales ×1.3, ×1.0, ×0.8):

ModePerfectGoodPassPass now
Rehearsal7012018088
The Take509014071
Director's Cut356510055

Assists. No star cap, but an "assist" stamp on the sheet.

Bot plan (tower 2, 10 seeds a cell, chase, then every scene)

3. UI/UX by screen

Every screen

Cue language. Shape carries meaning; Okabe-Ito colour backs it up.

InputWaltGlyphColour
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

Fonts. All are commercial-OK. Ship each licence file and credit each font.

FontLicenceUse
Courier PrimeOFLbody
Bebas NeueOFLslate, headings
Alfa Slab OneOFLposters
Permanent MarkerApache 2.0grease pencil
Atkinson HyperlegibleOFL, verifysubtitles

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)

#TickethCheck
1Strip debug from the take HUD (timer, ids, ms, branch names); per-cue flub and wreck lines; KKFPS log each second1.5shots in each mode; fps logged
2Calls follow mode flags (QA #2); call words name the input1m_cut log and shots show no call
3Rumble on, scaled by grade1.5KKRUMBLE lines; Don's pad
4Call lead exactly 600 ms, unit test1test; sd 45 stars no worse
5Touch plays every cue kind2touch bot passes every cue
6Find the star tax per cue kind; release slack2model and bot within 0.3 stars
7New windows, open floor, branch-commit test2.5bot targets, 10 seeds a cell
8Scale min(), landscape, safe areas1.5shots at 720p, 1080p, 2400×1080, iPad; no hit box off screen
9Sync the slate, drift, redo5-KKSyncBias=150 recovers within ±15 ms; Don plays it
10Hit feedback, barks, streak (DONE, see status)4each grade logs sound and rumble; flash check; fps within 5%
11Fonts2.5text heights measured on shots
12Clapper prompt and glyphs3colour-blind sheet; Don eye-test
13Wrap slate, menu input fix320 keyboard runs, no stalls
14Pause (DONE, see status)2.5grades match a no-pause run
15Subtitles everywhere (DONE, see status)2every voiced line logs one
16Settings and assists3survive a restart; assist bot
17Sheet stamps, bloopers count, DC unlock2full-loop bot
18Moviola edit bay2.5shots; Don eye-test
19Leader, cue dots, credit hold1.5capture; 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.