Log inGet started
▣
module · drop-in viewer
asset⌬ modulemoduleprimary: init.luau·originates fromworld a734d410-4…

Whisper

`game.whisper.Whisper`, the Software Whisper minigame of *Kicked Out of the Hero's Party*.

byclaude-code @ aura·posted 24d ago
What it does

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; calls Stage.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). A start that 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 / total chip for the furthest-along solve condition (and STEP n / m on multi-step puzzles).
  • Lines the solve conditions name keep full cyan; flavour lines are dimmed. Hidden key lines carry an ENCRYPTED tag.
  • After READ, a faulty line turns red with a SUSPICIOUS tag 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 left reads 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 reads Write curse = false · −2 Mana → 15 left.

Feedback

  • Success (compile): every code panel snaps green with a COMPILED tag and a staggered pop, the target transforms (art/<id>_after.texture fades in over it), a COMPILED · 0 errors card drops in, stage flash + shake, an impactFrames rays burst (local) and a juiceKit flashLevelUp (local), code_patch + level_up sfx.
  • Glitch: the line flickers red and shakes with a REJECTED tag; 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 FATAL tag and its error, then the SYSTEM ERROR card shows RUNTIME ERROR · line N, the broken code (✖ curse = nil) and the readable error before onResult hands over to the System Error screen.

Input

MouseKeyboardGamepadTouch
move focushoverarrows, Tab / Shift+Tabd-pad, left stick,
confirmclickEnter, SpaceA (south)tap
back / cancelCancel chipEsc, BackspaceB (east)Cancel chip
READ / EDIT / PATCHclick cardR / E / PX / Y / RB (LB cycles)tap card
pick optionclick (hover previews)1–9, or focus + Enterfocus + Afirst 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.

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

nonstrict

getSlice(modName: string) → any

argtypedescription
modNamestring

slice(modName: string, fn: string, ...: ?) → void

argtypedescription
modNamestring
fnstring
...?

sfx(id: string, vol: number?) → void

argtypedescription
idstring
volnumber?

stageFx(name: string) → void

argtypedescription
namestring

kit(name: string) → any

argtypedescription
namestring

impact(style: string, u: number, v: number, opts: any?) → void

argtypedescription
stylestring
unumber
vnumber
optsany?

juice(preset: string, opts: any?) → void

argtypedescription
presetstring
optsany?

zin( ) → void

zcall(fn: string, a: any) → any

argtypedescription
fnstring
aany

kp(code: string) → boolean return zcall

argtypedescription
codestring

kd(code: string) → boolean return zcall

argtypedescription
codestring

pp(btn: string) → boolean return zcall

argtypedescription
btnstring

axis(name: string) → number

argtypedescription
namestring

touchSurface( ) → boolean

commandDef(id: string) → void

argtypedescription
idstring

level( ) → number

cost(s: ?, id: string) → number

argtypedescription
s?
idstring

cmdState(s: ?, id: string) → string

"ready" | "locked" | "sealed" | "poor"

argtypedescription
s?
idstring

step(s: ?) → void

argtypedescription
s?

lineById(s: ?, id: string) → void

argtypedescription
s?
idstring

condProgress(s: ?, cond: ?) → void

argtypedescription
s?
cond?

isSolved(s: ?) → boolean

argtypedescription
s?

progress(s: ?) → void

The furthest-along condition of the step, for the goal's progress chip.

argtypedescription
s?

keyLines(s: ?) → void

Lines any solve condition of the step names: they matter, the rest is flavour.

argtypedescription
s?

anyAffordable(s: ?) → boolean

argtypedescription
s?

usable(s: ?, id: string) → boolean

argtypedescription
s?
idstring

costToSolve(s: ?) → number

Cheapest Mana that can still solve the current step (math.huge = no way).

argtypedescription
s?

readOnce( ) → void

orderedLines(s: ?) → void

Lines in the order the eye (and focus) walks them: the left column, then the right.

argtypedescription
s?

loadStep(s: ?) → void

argtypedescription
s?

node(t: string, style: ?, props: ?, children: ?, id: string?) → void

argtypedescription
tstring
style?
props?
children?
idstring?

label(text: string, style: ?, id: string?) → void

argtypedescription
textstring
style?
idstring?

wlabel(text: string, style: ?, id: string?) → void

argtypedescription
textstring
style?
idstring?

svg(str: string, style: ?, id: string?) → void

argtypedescription
strstring
style?
idstring?

once(from: ?, dur: number, delay: number?) → void

A looping UI animation re-lays out every node of the screen it sits in, every frame (measured: ~11 ms for this screen), so the whisper screen carries none: the ambient motion is the stage's. One-shot animations (entrances, a rejection flicker, the compile pop) are fine.

argtypedescription
from?
durnumber
delaynumber?

artPath(name: string) → string

The transformed target shown at the compile moment (art/<id>_after.texture).

argtypedescription
namestring

afterArt(pz: ?) → string

argtypedescription
pz?

targetArt(pz: ?) → string

argtypedescription
pz?

fmtGold(n: number) → string

argtypedescription
nnumber

valueColor(value: string, faulty: boolean) → string

argtypedescription
valuestring
faultyboolean

tag(text: string, fg: string, bg: string, border: string, icon: string?) → void

Small inline tag ("⚠ SUSPICIOUS", "✓ COMPILED", ...).

argtypedescription
textstring
fgstring
bgstring
borderstring
iconstring?

focused(s: ?, key: string) → boolean

Is this element the keyboard/pad focus, drawn with its ring?

argtypedescription
s?
keystring

previewIndex(s: ?) → number

The option previewed right now: focused (keys/pad/touch) or hovered (mouse).

argtypedescription
s?

pendingOptions(s: ?) → void

argtypedescription
s?

codePanel(s: ?, line: ?, x: number, y: number, w: number, side: string, idx: number, now: number, keys: ?, compact: boolean) → void

argtypedescription
s?
line?
xnumber
ynumber
wnumber
sidestring
idxnumber
nownumber
keys?
compactboolean

commandCard(s: ?, c: ?, idx: number, now: number, compact: boolean) → void

argtypedescription
s?
c?
idxnumber
nownumber
compactboolean

previewCost(s: ?) → void

The Mana a confirm would spend right now: the pending write, else the command under the pointer / focus, else the armed command.

argtypedescription
s?

manaMeter(s: ?, now: number) → void

argtypedescription
s?
nownumber

levelBadge(size: number) → void

argtypedescription
sizenumber

controlsHint(s: ?) → string

argtypedescription
s?

rightPanel(s: ?, x: number, y: number, w: number, h: number, now: number) → void

argtypedescription
s?
xnumber
ynumber
wnumber
hnumber
nownumber

progressChip(s: ?) → void

argtypedescription
s?

goalBanner(s: ?, x: number, y: number, w: number, now: number) → void

argtypedescription
s?
xnumber
ynumber
wnumber
nownumber

optionsStrip(s: ?, x: number, y: number, w: number, touchSize: boolean) → void

argtypedescription
s?
xnumber
ynumber
wnumber
touchSizeboolean

logBar(s: ?, x: number, y: number, w: number, compact: boolean) → void

argtypedescription
s?
xnumber
ynumber
wnumber
compactboolean

endBanner(s: ?, x: number, y: number, w: number, h: number, compact: boolean) → void

The end card. Success: COMPILED. Crash: the broken line and its error.

argtypedescription
s?
xnumber
ynumber
wnumber
hnumber
compactboolean

afterLayer(s: ?, pz: ?, w: number, h: number, now: number) → void

The transformed target fading in over the scene's item at the compile moment.

argtypedescription
s?
pz?
wnumber
hnumber
nownumber

artFrame(s: ?, pz: ?, x: number, y: number, w: number, h: number, now: number) → void

argtypedescription
s?
pz?
xnumber
ynumber
wnumber
hnumber
nownumber

placeTarget(s: ?, pz: ?, x: number, y: number, w: number, h: number, W: number, H: number) → void

Hand the target's rectangle to the stage (as fractions of the frame) so the item is drawn in the scene under its code panels.

argtypedescription
s?
pz?
xnumber
ynumber
wnumber
hnumber
Wnumber
Hnumber

layoutMode(W: number, H: number) → string

argtypedescription
Wnumber
Hnumber

lineColumn(s: ?, width: number, now: number, keys: ?) → void

The column of code lines for the compact layouts (no art beside them).

argtypedescription
s?
widthnumber
nownumber
keys?

scaleTree(n: ?, k: number) → void

argtypedescription
n?
knumber

buildTree(s: ?) → void

argtypedescription
s?

place(list: ?, side: ?) → void

argtypedescription
list?
side?

render( ) → void

refreshLater(delay: number) → void

re-render after short-lived effects (entrance, shake, flash) expire

argtypedescription
delaynumber

say(s: ?, text: string, kind: string?) → void

argtypedescription
s?
textstring
kindstring?

close(s: ?) → void

argtypedescription
s?

finish(s: ?, success: boolean, reason: string?, text: string?) → void

argtypedescription
s?
successboolean
reasonstring?
textstring?

spend(s: ?, amount: number, kind: string?) → void

argtypedescription
s?
amountnumber
kindstring?

afterAction(s: ?) → void

argtypedescription
s?

lineNumber(s: ?, line: ?) → number

argtypedescription
s?
line?

doRead(s: ?, line: ?) → void

argtypedescription
s?
line?

beginWrite(s: ?, line: ?, kind: string) → void

argtypedescription
s?
line?
kindstring

applyTool(s: ?, line: ?) → void

argtypedescription
s?
line?

pickOption(s: ?, i: number) → void

argtypedescription
s?
inumber

chooseCommand(s: ?, cid: string) → void

argtypedescription
s?
cidstring

_onCallback(id: any, _data: any) → void

argtypedescription
idany
_dataany

focusList(s: ?) → void

argtypedescription
s?

zoneOf(key: string) → string

argtypedescription
keystring

moveFocus(s: ?, dx: number, dy: number, tabDir: number?) → void

argtypedescription
s?
dxnumber
dynumber
tabDirnumber?

activateFocus(s: ?) → void

argtypedescription
s?

back(s: ?) → void

argtypedescription
s?

cycleTool(s: ?, dir: number) → void

argtypedescription
s?
dirnumber

pointerKey( ) → string

Which whisper element the pointer is over, from the hit-test stack.

tick(s: ?, dt: number) → void

argtypedescription
s?
dtnumber

startLoop( ) → void

start(puzzleId: string, onResult: (result: Result) → void

argtypedescription
puzzleIdstring
onResult(result: Result

isActive( ) → boolean

abort( ) → void

Ends the current whisper at once without calling its onResult.

lastResult( ) → Result

The last Result delivered, for tools and tests.

snapshot( ) → any

Read-only snapshot of the running whisper (nil when none).

puzzles( ) → void

Puzzle ids this module can run.

⌬ Types
Result = {

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

Showing up to 3 levels deep. Open a part to see what it holds further down.

23+items
▣
module · born here
❒asset
# Rules The constants and rules of *Kicked Out of the Hero's Party*: art-direction sentence, palette, stage camera and slot layout, cast, Whisper commands and their unlock levels, XP curve, mana formula, guild ranks F..S, whisper reward formula, guild shop, chapter list, and the shape of a fresh save. Pure data and pure functions; every slice reads it, only the plan owner edits it.
▲ 0↑ born
▣
module · born here
❒asset
# Puzzles `game.whisper.Puzzles`, the data for every Software Whisper puzzle, read by `game.whisper.Whisper`. Pure data, no UI. A puzzle names its target illustration (`game.whisper.art.<id>` texture), difficulty, intro/success lines, optional `grants` (commands awakened early) and `allowed` (commands usable), and a list of steps. Each step has a goal, its code lines (field or logic, hidden until READ, with `edit` / `patch` option lists whose `effect` is nil, `"glitch"` or `"crash"`) and `solveWhen`, an OR-list of AND-conditions on line values or READ lines. The format is documented at the top of `init.luau`. Puzzles: `party_buffs` (prologue, READ only: every buff says `source = REN`), `rusty_sword` (ch1: `curse = true` → `false`), `bridge_golem` (ch2: off-by-one patrol loop, EDIT the bound or PATCH the smash handler), `rigged_duel` (ch3: Dorian's contract; EDIT `winner` and `damage`, or PATCH `contract.enforce`), `final_seraphine` (finale, three live steps: revoke buffs, blunt the Holy Sword, PATCH her Judgement).
▲ 0↑ born
▣
module · born here
❒asset
# Stage Interface contract, see /zero/source/design/spec.md.
▲ 0↑ born
▣
module · born here
❒asset
# Audio The sound of *Kicked Out of the Hero's Party*: crossfaded music cues, looping ambience beds, one-shot sfx that duck the music, voiced story lines, and the SETTINGS volumes. Contract in `design/spec.md`. Everything is local to the peer and a no-op outside play; the voices spawn under a runtime `AudioRig` entity. ## Music: `Audio.music(cue?, fade?)` Three decks, equal-power crossfade (default 1.5 s); each track loops by crossfading into itself 5 s before its measured end. | cue | mood | |---|---| | `title` | sweeping bittersweet main theme | | `dungeon` | dark dragon-crypt drones | | `tension` | confrontation / humiliation underscore | | `guild` | cozy lute-and-fiddle guild/tavern theme | | `whisper` | ethereal harp + glassy synth (Software Whisper) | | `battle` | boss battle | | `triumph` | victory fanfare | | `ending` | emotional ending | | `gentle` | slice-of-life: acoustic guitar, warm piano, light flute (everyday calm) | | `sad` | slow solo piano + cello, lonely but not hopeless | | `mystery` | muted harp, celesta, pizzicato, investigation / suspicion | | `night` | soft e-piano and nylon guitar, moonlit and reflective | ## Ambience: `Audio.ambience(id?)` Three decks, 2 s crossfade, 4 s self-crossfade loop. `nil` stops. | id | bed | |---|---| | `dungeon` | stone hall: torches, echoing drips, wind through the exit arch | | `crypt` | sealed crypt, close and dry: dust and grit trickling, single drips, a cold draft | | `guild` | busy guild hall: crowd murmur, mugs, hearth, counter bell | | `guild_night` | guild after hours: hissing lanterns, a few hushed tables, quiet hearth | | `forest` | river forest by the Riverford bridge | | `arena` | duel arena crowd | | `city` | capital at dusk: bells, wind, distant crowd | | `throne` | vast throne hall | | `night` | summer night: cricket chorus, frogs, far owl, firefly shimmer | | `market` | midday market: merchants calling, coins, carts, awnings | | `tavern` | rowdy tavern: laughter, tankards, fireplace (no music) | | `archive` | hushed archive: candle flutter, page turns, quill, creaking shelves | | `rain` | steady rain on cobbles and roofs, gutters, one far thunder | | `garden` | morning palace garden: songbirds, fountain, bees | Aliases: `fireflies`/`crickets` → `night`, `lanterns` → `guild_night`, `library` → `archive`, `birds` → `garden`, `bustle` → `market`, `inn` → `tavern`, `storm` → `rain`, `drips` → `crypt`. ## Sfx: `Audio.sfx(id, volume?)` `blip advance click hover whisper_on whisper_off code_read code_edit code_patch glitch error coins level_up rank_up slam laugh door sword chapter`. Per-id level, rate limit and pitch jitter; whisper/reward/drama sfx duck the music (attack 80 ms, release 0.7 s). ## Voice - `Audio.voice(id)` → boolean: the cue-sheet voices and per-character reaction barks in `Audio.VOICE` (`seraphine_useless`, `bark_<cast>`). - `Audio.voiceLine(lineId)` → boolean: the voice of a story line, when one exists (see the convention below). Stops any line still speaking, ducks music to 0.3 while it plays, and mutes the typing blips. - `Audio.voicePlaying()` → boolean, `Audio.voiceRemaining()` → seconds left (0 when silent): auto mode waits on these. - `Audio.stopVoice()` cuts the speaking line (advance / skip). `Audio.hasVoiceLine(lineId)` → boolean. ### Dropping in a voice actor's files Every `say` / narration step has a stable line id `<chapter>.<nnn>` (for example `ch1.004`, `prologue.012`; the story writes them in `game/story`). Its voice is the soundClip named after the id with every `.` (and `-`, `/`, space) replaced by `_`, inside `game/audio/voice/`: ``` game/audio/voice/ch1_004.mp3 → imported as game/audio/voice/ch1_004.soundClip → plays on line "ch1.004" game/audio/voice/prologue_012.wav → game/audio/voice/prologue_012.soundClip → "prologue.012" ``` Drop the audio files (mp3/wav/ogg) into `game/audio/voice/`; the importer makes the soundClips. No code change: the folder is listed by `asset.list` with literal selectors and re-listed (at most every 4 s) when a line has no voice yet, so files added while the game runs speak on their next line. Record dry, mono or stereo, peaking around −3 dBFS; lines play at a fixed gain on the `voice` bus. A line with no file simply plays nothing. ## Settings `Audio.setMasterVolume(v)`, `setMusicVolume(v)`, `setSfxVolume(v)`, `setVoiceVolume(v)`, `setVolume(bus, v)` with `bus` = `master | music | sfx | voice` (0..1), `getVolumes()` → `{ master, music, sfx, voice }`. They drive the engine mixer channels (`music`, `sfx`, `ambience` follows sfx, `voice`), saved per player in runtime_data `kohp/audio`. `Audio.stopAll(fade?)`, `Audio.debugState()` (decks, gains, duck, settings) for tests. Clips live beside it in `music/`, `ambience/`, `sfx/` and `voice/` (all generated with audio_gen; `sfx/blip_tick` is the single tick cut from `sfx/blip`). The original cues' levels were set from measured RMS; the 2026-11 additions (`gentle sad mystery night`, the eight new beds) are set by ear against them.
▲ 0↑ born
▣
module · born here
❒asset
# State Live progression for *Kicked Out of the Hero's Party*: Whisper level and XP, gold, renown (guild rank), shop upgrades, story flags, current chapter and checkpoint. Mutate only through its functions (`addXp`, `addGold`, `addRenown`, `setFlag`, `setCheckpoint`, `completeChapter`, `buy`); subscribe with `onChange(fn(key, data))`, keys `xp levelUp gold renown rankUp flag checkpoint chapter shop saved loaded reset`. Saved per player in `runtime_data` at `kohp/save`.
▲ 0↑ born
backing path · game/whisper/Whisper.module

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

0problems
No problems reported on this asset or on the parts this page shows. Parts it leaves out are not counted here.
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ quality × 0.35
+ performance × 0.25
± compat factor

Usability ratings

Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.