Sound.module
README.md
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.