Whisper.module
This package holds more than this page lists. See all of its files in its world.
README.md
Whisper
game.whisper.Whisper, the Software Whisper minigame of Kicked Out of the Hero's Party.
The target floats in a holographic scan window in the centre (drawn by the stage for the five story targets, by this screen for every other puzzle) and splits into floating cyan code panels; the right-hand command codex (gold-filigree indigo glass) holds READ / EDIT / PATCH, the segmented Mana meter with its spend preview, the Whisper Lv badge and gold. A goal banner with a progress chip runs across the top and a whisper log along the bottom. Puzzle content is data in game.whisper.Puzzles.
API (contract in design/spec.md)
start(puzzleId, onResult), opens the whisper; callsStage.whisperMode(true),Stage.fx("code_rain"),Audio.sfx("whisper_on").onResult(Result)fires after the end card (2.4 s success, 3.0 s crash, 1.8 s out of Mana). Astartthat supersedes a running whisper delivers{ success = false, reason = "aborted" }to the old callback.isActive(),abort()(closes silently, no callback).Result = { success, reason? ("mana" | "crash" | "aborted"), manaLeft, manaMax, difficulty }. Never grants rewards.- Extras for tools/tests:
lastResult(),snapshot()(puzzle step steps mana manaMax tool pending values read ended focus navShow hover mode preview broke compiled),puzzles().
Reading it at a glance
- The GOAL is the largest text on screen, with a
done / totalchip for the furthest-along solve condition (andSTEP n / mon multi-step puzzles). - Lines the solve conditions name keep full cyan; flavour lines are dimmed. Hidden key lines carry an
ENCRYPTEDtag. - After READ, a faulty line turns red with a
SUSPICIOUStag and its note; the Debugger's Lens marks faults with a gold "!" from the start. - Mana cost is previewed on hover / focus of a command and while a write is pending: the segments it would spend glow gold and
EDIT −2 → 15 leftreads under the meter. - A pending EDIT / PATCH previews its effect before it is confirmed: the line shows
old → new(old struck through) and the options strip readsWrite curse = false · −2 Mana → 15 left.
Feedback
- Success (compile): every code panel snaps green with a
COMPILEDtag and a staggered pop, the target transforms (art/<id>_after.texturefades in over it), aCOMPILED · 0 errorscard drops in, stage flash + shake, an impactFrames rays burst (local) and a juiceKitflashLevelUp(local),code_patch+level_upsfx. - Glitch: the line flickers red and shakes with a
REJECTEDtag; the spent Mana chunk shatters off the meter in red; the log turns red. - Crash: the line takes the fatal value, turns red with a
FATALtag and its error, then the SYSTEM ERROR card showsRUNTIME ERROR · line N, the broken code (✖ curse = nil) and the readable error beforeonResulthands over to the System Error screen.
Input
| Mouse | Keyboard | Gamepad | Touch | |
|---|---|---|---|---|
| move focus | hover | arrows, Tab / Shift+Tab | d-pad, left stick | , |
| confirm | click | Enter, Space | A (south) | tap |
| back / cancel | Cancel chip | Esc, Backspace | B (east) | Cancel chip |
| READ / EDIT / PATCH | click card | R / E / P | X / Y / RB (LB cycles) | tap card |
| pick option | click (hover previews) | 1–9, or focus + Enter | focus + A | first tap previews, second writes |
Focus walks the code lines and the command rail (left/right switches between them on landscape; on portrait the rail is below the lines, so down from the last line enters it). A pending write makes the options strip modal. The focus ring only appears once a key or pad is used, and a real mouse move hands control back to the pointer. The reader's own input is blocked while a whisper is active (UI blocking).
Layouts
- wide (landscape ≥ 900 × 640 pt): art centre, panels left/right, codex rail right.
- compact (very wide, short screens): lines in a column, a narrow command rail on the right.
- portrait (W < H): one column on a ~430 pt design width scaled up to the canvas (text stays readable, targets ≥ 48 pt), small target painting, lines, options, log, Mana, and the command rail along the bottom. Resizes / rotations re-lay out live.
Art
art/<id>.texture, target illustrations (dark indigo #0b0d26 backdrop); art/<id>_key.texture, the stage's keyed versions; art/<id>_after.texture, the transformed target shown at the compile moment. Side-quest targets: bakery_oven guild_ledger gorvin_hammer archive_seal garden_fountain (+ _after). codex_corner, codex_sigil, the codex frame.
UI: screen whisper_mode at layer 90, callbacks prefixed wsp: through ui.registerCallbackEnv("whisper", …); element ids wsp_cmd_<READ|EDIT|PATCH>, wsp_line_<lineId>, wsp_opt_<n>, wsp_cancel, wsp_mana, wsp_mana_preview, wsp_opt_preview, wsp_progress, wsp_end_title, wsp_end_line, wsp_rail.