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

synth

<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->

by◐lolboy21·posted 1mo ago
What it does

synth

<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->

TODO: describe this module.

Interface

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

conforms to

zero/source-extract/v2

game.audio.synth — UNBROKEN FRONT's sound bank, computed rather than bought. Every clip in the game is synthesised here from arithmetic and baked into a `.soundClip` asset by `Synth.bake()`, which runs once at authoring time. The world then ships the baked bytes: nothing is synthesised during play, and nothing depends on a generation service, a credit balance or a network — a sound cannot fail to arrive because a request did. What each sound is made of: gunshot a very short bright transient, a low body note for the chest thump, and a filtered noise tail for the report. The three are mixed at different delays and decays, which is what separates a crack from a thud. A weapon's character is the body frequency, the tail length and the brightness — so seven weapons get seven sounds from one recipe rather than one sound at seven pitches. click a single short shaped impulse. Magazine catches, selectors and a trigger falling on an empty chamber are all this, at different pitches and decay times. action a scrape (bandpassed noise, slow attack) into a clack (impulse + short body) — a bolt or a charging handle. step a low thump with a surface-dependent top: bright grit on concrete, a ringing partial on metal, a dead thud on dirt. impact the same shape as a step but shorter and harder, and on metal it rings. Everything is mono and 24 kHz. These are short, percussive, and positional; stereo would double the bytes to place a click in the middle of the head.

makeNoise(seed: ?) → void

The bench Deterministic noise. Two different seeds give two different fields, so a transient and a tail do not correlate into a single obvious tone.

argtypedescription
seed?

lowpass(cut: ?, sr: ?) → void

A one-pole lowpass: the cheapest way to take the fizz off noise.

argtypedescription
cut?
sr?

highpass(cut: ?, sr: ?) → void

A one-pole highpass, which with a lowpass makes a band.

argtypedescription
cut?
sr?

bandpass(freq: ?, q: ?, sr: ?) → void

A Chamberlin state-variable bandpass: two poles, so it RINGS on an impulse rather than merely shaping it. This is what gives metal a pitch.

argtypedescription
freq?
q?
sr?

decay(t: ?, len: ?) → void

Exponential decay, 1 at the attack and approaching 0 across `len` seconds.

argtypedescription
t?
len?

alloc(seconds: ?) → void

A buffer of `seconds` at the bank's rate.

argtypedescription
seconds?

put(buf: ?, i: ?, v: ?) → void

argtypedescription
buf?
i?
v?

read(buf: ?, i: ?) → void

argtypedescription
buf?
i?

mixInto(dst: ?, src: ?, gain: ?, offset: ?) → void

argtypedescription
dst?
src?
gain?
offset?

gunshot(seed: ?, body: ?, tail: ?, bright: ?, bodyGain: ?) → void

Recipes A gunshot. `body` is the chest-thump frequency, `tail` the report length, `bright` how much high noise sits on the front.

argtypedescription
seed?
body?
tail?
bright?
bodyGain?

click(seed: ?, freq: ?, len: ?, ring: ?) → void

A short shaped impulse. Every mechanical click in the game is this.

argtypedescription
seed?
freq?
len?
ring?

action(seed: ?, scrapeLen: ?, freq: ?, clackAt: ?) → void

A scrape into a clack: a bolt, a charging handle, a magazine going home.

argtypedescription
seed?
scrapeLen?
freq?
clackAt?

step(seed: ?, top: ?, ring: ?, len: ?) → void

A footfall. `top` shapes the surface: bright grit, a ringing partial, or a dead thud.

argtypedescription
seed?
top?
ring?
len?

bake(root: ?) → void

Write every clip in the bank. It WRITES OVER an existing clip rather than leaving it alone. The bank is the source of truth for these sounds — they are computed here and nowhere else — so a clip that disagrees with the bank is a stale artifact, not an edit to be preserved. Leaving them alone is how this world ended up with nineteen `.soundClip` containers whose `data.zaud` had been written to the wrong identity and read back as "no readable bytes": every shot was silent and nothing said so.

argtypedescription
root?

Sub-parts

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

3items
This part has no composite children. See the Files segment for its leaf payloads.
backing path · game/audio/synth.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. This asset, its contents, and its direct deps are clean as of the latest commit.
⌬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.