bank

Every sound Helsinki Life makes, and how loud each one sits.

One recipe per name, each a pure function returning a game.sound.synth track - so the same bake produces the same samples on any machine, and nothing here reaches the network or the host. game.sound.Sound reads the baked clips back; nothing else needs this module.

What it holds

• The 22 named effects - exactly HL.SFX, the contract the other slices emit against with HL.emit("sfx", { name }). Everything is in D major so a UI click, a payday and the music bed agree with each other.
• The two long beds - bed (a 28 s waltz) and harbour (a 16 s quay ambience). Both are stored as pcm rather than Opus: a bed's last frame runs into its first once a lap, and a lossy round trip moves the samples on both sides of that join.
• The mix - CHANNELS (the level each channel sits at), SFX_GAIN (per-effect trim), BED_BY_PHASE (how loud the music is in each phase of the game) and DUCK (how far the beds drop under the Konduktööri).

Where the beds come from

The preferred source is a generated take, cut down to a seamless loop by folding its continuation back over its head. The prompts that made the takes this world ships are written at the top of the beds section in init.luau, so the pair can be made again.

When there is no take - the service is down, the credit is spent, a clone of this world wants to rebuild from source alone - synthBed() and synthHarbour() make the same two beds out of arithmetic instead: a 12-bar D major waltz in 3/4, and a harbour of drones, water grains, four gulls and a far-off tram bell. The game is never left silent by a generation that did not happen.

Baking

Run from an execute, never from a component: a create made inside a component callback is filed in the ephemeral runtime store, which is not what a clip the world ships wants to be.

local Bank = require("game.sound.bank")
Bank.bakeSfxAll()                        -- the 22 named effects
Bank.bakeTake("harbour", pcm, rate, ch, Bank.AMBIENCE_SPEC)
Bank.missing()                           -- what this world has not got

At runtime, Bank.resolve(name) hands back the clip or nil. Every asset reference in it is a static identity literal - a computed asset.resolve cannot be pinned, and a world holding one cannot be published.