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

Sound

The game's voice, in one module: the region bordón, the impact, the echo bell, the footsteps and the boss theme.

by◐Catapulta33·posted 9d ago
What it does

umbral.sound.Sound

The game's voice, in one module: the region bordón, the impact, the echo bell, the footsteps and the boss theme.

local Sound = require("umbral.sound.Sound")
Sound.region("nave")   -- pitch the drone to that region's note, from Config.REGIONS
Sound.impact()         -- a landed strike: dry impact, metal tail, room resonance
Sound.bell()           -- the echo bell
Sound.step()           -- one hollow metal footstep
Sound.music("boss")    -- El Ciego de la Nave's theme; Sound.music() stops it

It owns one entity with three Audio components (ambience / music / one-shots), created on first use and reused after, and it resolves each clip from umbral/sound/clips/ — a clip that is not baked yet is skipped instead of raising, so the game keeps running.

The bordón is one generated bowed drone, pitched per region to the note umbral.Config.REGIONS gives it (D2 at the Campanario, A1 in the Nave, …). corazon has no note on purpose: the Corazón de la Campana is the one region with no drone, and that silence is the design.

Interface

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

conforms to

zero/source-extract/v2

UMBRAL · the voice of the game. One place that holds the game's sound: the region's bordón (one bowed low drone, pitched to the note `umbral.Config.REGIONS` gives the room), the three-layer impact of a landed strike, the echo bell, Ilva's hollow metal footsteps, and the boss theme. Any slice can call it without owning an entity of its own: local Sound = require("umbral.sound.Sound") Sound.impact() Sound.bell() Sound.step() Sound.region("nave") The clips live in `umbral/sound/clips/`. One that is not baked yet is skipped rather than raising, so the game runs while they are made.

Audio

noteFrequency(name: ?) → void

equal-tempered frequency of a note name: the ratio from D2 is the pitch one recorded drone has to play at to sit on a region's own note

argtypedescription
name?

clip(name: ?) → void

Each clip is named at a static literal, so the reference is one the world can pin: one computed from a variable is refused on push. A clip that failed to resolve once is remembered rather than retried every frame.

argtypedescription
name?

deck(name: ?, opts: ?) → void

One entity per deck, found by name, so a hot reload of this module picks today's decks up instead of trying to add a second Audio to an entity that already has one.

argtypedescription
name?
opts?

alive(c: ?) → void

A deck is only good while its entity lives: entering play or reloading the scene despawns the entity the components hang on, and a proxy to one that is gone refuses every write, which is silence with no error of its own.

argtypedescription
c?

ensure( ) → void

region(id: ?) → void

One drone, pitched to the region's own note. The Corazón has none: the silence there is the point.

argtypedescription
id?

shot(name: ?, opts: ?, gap: ?) → void

argtypedescription
name?
opts?
gap?

impact(strength: ?) → void

argtypedescription
strength?

bell( ) → void

step(intensity: ?) → void

argtypedescription
intensity?

hurt( ) → void

music(kind: ?) → void

argtypedescription
kind?

setVolume(which: ?, v: ?) → void

argtypedescription
which?
v?

Sub-parts

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

33items
·
soundclip · born here
❒asset
# eco_campana This sound clip is a single strike of a colossal, cracked bronze cathedral bell, heard as if underwater, with a deep and long ringing echo. It is intended as a sound effect for a game.
▲ 0↑ born
·
soundclip · born here
❒asset
# tema_jefe This sound clip is a boss theme featuring a slow, heavy, low bowed strings ostinato, real bronze bells struck as punctuation, a wordless low choir, and metallic percussion played like hammers on iron. It is intended to be menacing, patient, and gothic, without modern drums, for a metroidvania game with a submerged cathedral aesthetic.
▲ 0↑ born
·
soundclip · born here
❒asset
# paso_metal This sound clip is a single, hollow metal footstep of an empty bronze armored figure on wet stone, described as short and dry. It is intended as a sound effect for a game.
▲ 0↑ born
·
soundclip · born here
❒asset
# bordon_D2 This sound clip is a sustained, very low bowed double bass note on D2, with a faint bronze bell overtone shimmering above it. It is intended as a seamless ambient loop for a drowned cathedral setting, providing a quiet and steady drone for minutes.
▲ 0↑ born
·
soundclip · born here
❒asset
# impact This sound clip is a heavy strike of a bronze bell clapper on hollow metal armor, producing a dry, blunt impact with a metallic ringing tail. It is a close and weighty sound effect for a game.
▲ 0↑ born
backing path · umbral/sound/Sound.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.