Labyricorn/SciFi-XZBT
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync sound_reference.md and telemetry_elements.md with Phase 3 audio work

Browse Source 
Phase 3 shipped bespoke who/bioship/belter telemetry eras, the transporter/
flak/breech/docking/tape-spooler/teletype one-shots, and the zocalo/teletype/
heterodyne continuous beds, but the two reference docs still described those
as outstanding gaps or "Phase 3 scope". Add Phase 3 additions sections per
universe and correct the now-stale preset/era tables.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01582UUCEBExzp3oK3Spz1Xx
This commit is contained in:
Claude
2026-09-04 17:21:53 +00:00
co-authored by Claude Sonnet 5
parent 057b155a61
commit 292d3cd916
2 changed files with 219 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files
telemetry_elements.md
+87 -39
View File
@@ -27,6 +27,12 @@ events rather than running continuously.
| **NX Indicator Beep** | `synthesizeNXIndicatorBeep()` | 80 ms 950 Hz sine with a flat sustain plateau and a fast tail. Plain and utilitarian; no glide, no scale membership. | NX auto-scheduler (50%) |
| **TNG Door Chime** | `synthesizeDoorChime()` | Two overlapping sines, A5 (880 Hz) then D6 (1174.66 Hz) at +160 ms, each with a long 450–700 ms decay. The "come in" chime. | Soundboard `btn-chirp-door` only — **never** fired by the auto-scheduler |
The table above is the original five-era Starfleet vocabulary. Phase 3 added
three more eras — `who`, `bioship`, `belter` — but they don't fit this table's
shape: each fires a **multi-event generator** (a whole 0.25–1.4 s phrase of
staggered transients per tick) rather than picking one discrete element. They
are catalogued in [Phase 3 telemetry eras](#phase-3-telemetry-eras) below.
---
## The auto-scheduler
@@ -57,13 +63,19 @@ an era or a new element.
| `tos` | Computer Warble 60% · Relay Click 40% |
| `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| `nx` | Hydraulic Relay 50% · Indicator Beep 50% |
| `who` (Phase 3) | Dedicated mechanical-telemetry generator — see [Phase 3 telemetry eras](#phase-3-telemetry-eras) |
| `bioship` (Phase 3) | Dedicated organic-telemetry generator — see [Phase 3 telemetry eras](#phase-3-telemetry-eras) |
| `belter` (Phase 3) | Dedicated jury-rigged-telemetry generator — see [Phase 3 telemetry eras](#phase-3-telemetry-eras) |
Note the era is a **telemetry** property, not a universe property: it is set
per preset in `js/config.js` (`telemetry.era`) and is independent of the
universe that governs the visuals. In practice every preset in every universe
uses one of these five Trek eras, so non-Trek themes play Trek telemetry — see
universe that governs the visuals. Originally every preset in every universe
used one of the five Trek eras, so non-Trek themes played Trek telemetry.
Phase 3 gave three universes their own dedicated eras instead (Whoniverse →
`who`, Bioships → `bioship`, and Ceres/Tycho/Rocinante → `belter`) — the
remaining universes still borrow Trek telemetry. See
[Preset → telemetry era reference](#preset--telemetry-era-reference) for the
full per-preset mapping.
full, corrected per-preset mapping.
---
@@ -105,7 +117,33 @@ than inventing loose frequencies — they are what makes the layer sound coheren
matching the era's less "designed" sound.
Unpitched elements (relay clicks, sweeps, the Cardassian tone) generate their
own frequencies and intentionally sit outside both scales.
own frequencies and intentionally sit outside both scales. The three Phase 3
eras below are unpitched entirely — none of them touch `lcarsPitches` or
`tosFrequencies`, on purpose: they are meant to sound like mechanisms, not
computers.
---
## Phase 3 telemetry eras
Added under audio_gaps.md Phase 3 to give three universes a telemetry
vocabulary of their own instead of borrowed Trek chirps. Each is a private
method (trailing underscore, by convention for the multi-event generators
added in this phase) invoked once per scheduler tick from the same
`playRandomTelemetrySound()` switch as the five Trek eras — but where a Trek
era picks **one** discrete element, each Phase 3 era fires a **whole phrase**
of several staggered transients scheduled on absolute `ctx` time in a single
call.
| Era | Method (TelemetrySynth) | Universe(s) | Acoustic output |
| --- | --- | --- | --- |
| `who` | `synthesizeWhoMechanicalTelemetry_()` | Whoniverse (all 7 `tardis-*` presets) | 2–5 transients per tick, drawn at random from: dual-filtered toggle snaps (20–45 ms noise pulses through paired bandpass filters), 60–120 Hz spring-lever square clicks collapsing in pitch, and damped sine rotary-selector clunks. No electronic beeps. |
| `bioship` | `synthesizeBioshipOrganicTelemetry_()` | Bioships (all 6 `bio-*` presets) | 2–4 events per phrase: asymmetric 30–90 Hz vascular-surge sine thumps (sometimes with a lub-dub echo beat), high-Q bandpass chitin-snap noise ticks, bandpass-filtered wet bioplasmic fluid pops, and AM-stepped membrane-flutter noise between 300–700 Hz. |
| `belter` | `synthesizeBelterJuryRiggedTelemetry_()` | `sta-tycho`, `sta-ceres` (Space Stations) and `ind-rocinante` (Industrial) | 3–6 events per volley: jittered square relay pulses with randomized micro-dropouts, contact-bounce double/triple clicks, metallic bandpass ticks, and unstable "dying oscillator" clock pings — plus an occasional late catch-up sub-volley mimicking a station clock that skips then recovers. |
These three eras are documented in full, with source-material context, in
[`sound_reference.md`](sound_reference.md) under each universe's "Phase 3
additions" section.
---
@@ -182,11 +220,15 @@ no existing element has. In that case:
`telemetry.era` is assigned **per preset**, and it is the only thing that
decides which elements the auto-scheduler fires. It is *not* derived from the
universe. All 70 presets across all 10 universes currently use one of the five
Star Trek eras, so non-Trek universes play Trek telemetry: a retrofuture profile
can chatter in TOS warbles, and a living-ship profile can ring with the
Cardassian sensor tone. If you hear a sound that seems foreign to the theme you
are on, this table is where to look it up.
universe. Originally all 70 presets across all 10 universes used one of the
five Star Trek eras, so non-Trek universes played Trek telemetry: a
retrofuture profile could chatter in TOS warbles, and a living-ship profile
could ring with the Cardassian sensor tone. Phase 3 broke that pattern for
three universes — see [Phase 3 telemetry eras](#phase-3-telemetry-eras) above —
so Whoniverse, Bioships, and three `belter` presets (Tycho, Ceres, Rocinante)
now have their own vocabulary instead. Everything else below still borrows
Trek telemetry; if you hear a sound that seems foreign to the theme you are
on, this table is where to look it up.
| Era | Elements fired |
| --- | --- |
@@ -195,6 +237,9 @@ are on, this table is where to look it up.
| `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| `who` | `who`-era mechanical telemetry (see above) |
| `bioship` | `bioship`-era organic telemetry (see above) |
| `belter` | `belter`-era jury-rigged telemetry (see above) |
### Starfleet Command (10 presets — ds9 ×2 · nx ×1 · tng ×3 · tos ×2 · voyager ×2)
@@ -211,19 +256,19 @@ are on, this table is where to look it up.
| Enterprise NCC-1701: Engineering (TOS) | `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| Enterprise NX-01: Command Bridge | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
### The Whoniverse (7 presets — ds9 ×1 · nx ×1 · tng ×2 · tos ×1 · voyager ×2)
### The Whoniverse (7 presets — who ×7, all Phase 3)
| Preset | Era | Elements heard |
| --- | --- | --- |
| 1963 Classic Console (1st / 2nd Doctors) | `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| Victorian Secondary Console (4th Doctor) | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| The Coral Living TARDIS (9th / 10th Doctors) | `tng` | Single Chirp 45% · Double Chirp 30% · Ack Sequence 15% · Sensor Sweep 10% |
| The Copper Workshop (11th Doctor) | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| The Cold Machine (12th Doctor) | `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| The Singing Crystal Console (13th Doctor) | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| The Infinite White (14th / 15th Doctors) | `tng` | Single Chirp 45% · Double Chirp 30% · Ack Sequence 15% · Sensor Sweep 10% |
| 1963 Classic Console (1st / 2nd Doctors) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| Victorian Secondary Console (4th Doctor) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| The Coral Living TARDIS (9th / 10th Doctors) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| The Copper Workshop (11th Doctor) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| The Cold Machine (12th Doctor) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| The Singing Crystal Console (13th Doctor) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
| The Infinite White (14th / 15th Doctors) | `who` | `who`-era mechanical telemetry (2–5 transients/tick) |
### Industrial (8 presets — ds9 ×1 · nx ×3 · tos ×3 · voyager ×1)
### Industrial (8 presets — belter ×1 · ds9 ×1 · nx ×3 · tos ×3, 1 Phase 3)
| Preset | Era | Elements heard |
| --- | --- | --- |
@@ -232,20 +277,20 @@ are on, this table is where to look it up.
| Red Dwarf: Main Drive Corridor | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| Starbug 1: Cockpit Environment | `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| The Raza: Dark Matter Bridge | `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| Rocinante: Combat Ops & Epstein Drive | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| Rocinante: Combat Ops & Epstein Drive | `belter` | `belter`-era jury-rigged telemetry (3–6 events/volley) |
| Eagle Transporter: Command Module | `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| Valley Forge: Agro-Dome Forest Hub | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
### Bioships (6 presets — ds9 ×1 · nx ×2 · tng ×1 · voyager ×2)
### Bioships (6 presets — bioship ×6, all Phase 3)
| Preset | Era | Elements heard |
| --- | --- | --- |
| Moya: Leviathan Central Nexus | `tng` | Single Chirp 45% · Double Chirp 30% · Ack Sequence 15% · Sensor Sweep 10% |
| Talyn: Gunship Neural Bridge | `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| The Lexx: Primary Organ Bridge | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| Vorlon Cruiser: Sentient Core | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| Wraith Hive Ship: Throne Chamber | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| Species 8472: Fluidic Bioship | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| Moya: Leviathan Central Nexus | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
| Talyn: Gunship Neural Bridge | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
| The Lexx: Primary Organ Bridge | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
| Vorlon Cruiser: Sentient Core | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
| Wraith Hive Ship: Throne Chamber | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
| Species 8472: Fluidic Bioship | `bioship` | `bioship`-era organic telemetry (2–4 events/phrase) |
### Retrofuture (8 presets — nx ×2 · tng ×2 · tos ×3 · voyager ×1)
@@ -295,15 +340,15 @@ are on, this table is where to look it up.
| The Marauder: Havoc Shuttle Bridge | `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| The Milano: M-Ship Cockpit Lounge | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
### Space Stations (6 presets — ds9 ×1 · nx ×2 · tng ×1 · tos ×1 · voyager ×1)
### Space Stations (6 presets — belter ×2 · ds9 ×1 · nx ×1 · tng ×1 · tos ×1, 2 Phase 3)
| Preset | Era | Elements heard |
| --- | --- | --- |
| Babylon 5: Core Control & Zocalo | `ds9` | Cardassian Sensor 50% · Single Chirp 50% |
| Moonbase Alpha: Main Mission Control | `tos` | TOS Computer Warble 60% · TOS Relay Click 40% |
| Sevastopol Station: Habitation Deck | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| Tycho Station: Asteroid Construction Bay | `voyager` | Double Chirp 60% · Sensor Sweep 40% |
| Ceres Station: Sub-Crustal Tunnels | `nx` | NX Hydraulic Relay 50% · NX Indicator Beep 50% |
| Tycho Station: Asteroid Construction Bay | `belter` | `belter`-era jury-rigged telemetry (3–6 events/volley) |
| Ceres Station: Sub-Crustal Tunnels | `belter` | `belter`-era jury-rigged telemetry (3–6 events/volley) |
| Gateway Station: Quarantine Transfer Deck | `tng` | Single Chirp 45% · Double Chirp 30% · Ack Sequence 15% · Sensor Sweep 10% |
### Comedy (5 presets — nx ×1 · tng ×2 · tos ×1 · voyager ×1)
@@ -319,25 +364,28 @@ are on, this table is where to look it up.
### Notes on the spread
- **Starfleet** is the only universe where the era always matches the fiction.
- **Whoniverse** spans all five eras across its seven presets — the widest
spread of any universe, and the most likely place to hear something
unexpected.
- **Whoniverse** and **Bioships** no longer borrow Trek eras at all as of
Phase 3 — every preset in both universes runs its own dedicated era
(`who`, `bioship`).
- **Space Stations** and **Industrial** are mixed: Tycho, Ceres (Space
Stations) and Rocinante (Industrial) run the Phase 3 `belter` era; the rest
of both universes still borrow Trek eras.
- **Retrofuture** leans on `tos` (3 of 8), which is at least era-plausible for
mid-century-styled ships, but `Discovery One` and `The Searcher` are on full
TNG LCARS.
- **Bioships** has no acoustic relationship to any Trek era; `Talyn` on `ds9`
produces the Cardassian tritone tone inside a living-ship profile.
- **Comedy** and **Spaceball One** on `tos` produce the analog warble.
TNG LCARS. Untouched by Phase 3's telemetry-era work.
- **Comedy**, **Outlaw**, **Deep Space**, and **Military** are entirely
Trek-era telemetry, also untouched by Phase 3.
Two consequences worth keeping in mind when editing:
1. Changing a preset's `telemetry.era` silently changes which sounds it makes.
There is no UI anywhere that names the active era, so the change is audible
but not visible.
2. Any era value outside the five above falls through the `switch` in
2. Any era value outside the eight above falls through the `switch` in
`playRandomTelemetrySound()` to the `tng` default. A typo does not fail
loudly — it just produces LCARS chirps.
If a universe should stop borrowing Trek telemetry, the fix is a new era
vocabulary (new elements plus a new `case` in the era router), not a change to
these preset assignments alone — the router has nothing else to offer them.
vocabulary (new elements plus a new `case` in the era router) — exactly what
Phase 3 did for `who`, `bioship`, and `belter` — not a change to preset
assignments alone; the router has nothing else to offer them otherwise.