ferravex
GitHub

Voltage Choir

A complete four-lane rhythm concert about bringing a silent city back to life. Play six original authored arrangements, restore six districts and reach the citywide finale. A clean full concert takes about four minutes, plus the time you spend on song cards and results. The melodies, charts, rules and procedural concert art are first-party source; there are no downloaded songs or assets.

Your concert

SongDistrictTempoBarsNotesAccuracy target
First SparkRooftop Workshop100 BPM124460%
Copper StepsMidnight Tram120 BPM168062%
Glass RainWinter Garden120 BPM209665%
Night CircuitElectric Arcade150 BPM2014665%
Aurora CurrentNorthlight Tower150 BPM2416268%
Voltage ChoirThe Whole City150 BPM3223270%

The 760 notes progress from steady single beats through offbeats, rests, staircases and simultaneous chords. Every song has its own authored motifs, arrangement, melody, bass progression, introduction and lesson. The soundtrack uses tick-synchronous lead, bass and harmony notes through the shared host's bounded procedural music voices. It continues independently of whether you hit or miss the chart.

Controls

The chart stops during the shared pause, help and controls screens. The game is intended for desktop keyboard play; pointer input is supplementary. Pointer clicks use the same rule paths as their keys, and hovering a lane, the full Encore meter or a card button highlights it.

Reading the stage

The play screen speaks in icons, meters and motion rather than sentences.

Judgments, scoring and retries

The model runs at 60 fixed ticks per second. A note is Perfect within two ticks of its target (about 33 ms), Good within four (67 ms), and Okay within seven (117 ms). The boundaries include both early and late input. A note more than seven ticks late is missed. If two same-lane note windows overlap, the closest pending note wins, with earlier notes winning a tie. One edge can judge at most one note in its lane.

Perfect/Good/Okay notes give 100/75/45 base points. The combo raises the multiplier at every 20 consecutive hits, up to x5. A completed song also awards twice its accuracy in thousandths. Accuracy weights Perfect/Good/Okay/Miss as 1000/850/600/0; empty taps do not earn notes or points, cost two crowd energy and break the combo. A missed note costs ten crowd energy and breaks the combo. Perfect and Good hits restore one energy, capped at 100. Each song begins at 80.

Hits fill Encore (4 charge for Perfect, 3 for Good, 1 for Okay). At 100, X spends the charge for eight beats of protected miss/empty-tap damage and 25 additional points per hit. Misses still lower accuracy and break the combo. Encore is a tactical safety net, not a way to skip the chart's accuracy target.

You must finish each song above zero crowd energy and meet its accuracy target. There are three retry tickets for the whole concert. A retry clears that song's judgments, energy, combo, charge and attempt points; completed-song points remain banked. Failing without a ticket ends the concert. Complete the final track and take the final bow for the citywide ending, aggregate accuracy and personal-record score. Song results show S+/S/A/B/C/D grades and timing counts.

Watch the lane ahead of the line, especially before a chord. Keep your hands quiet during Glass Rain's rests. Save an Encore for a dense passage instead of spending it immediately. If your audio device adds latency, the visible judgment line remains the authoritative timing reference; no device latency calibration or audible synchronization quality is claimed.

Run and check

From the repository root:

cargo run -p voltage-choir --offline --locked -j 2
cargo run -p voltage-choir --offline --locked -j 2 -- --headless
cargo test -p voltage-choir --offline --locked -j 2
cargo clippy -p voltage-choir --all-targets --offline --locked -j 2 -- -D warnings

The native renderer needs a graphics display. Parent-owned catalog and browser build integration use the same model through ferravex-arcade. Best scores and completed-run records use its existing local storage; an unfinished concert is not saved. Autoplay calls the same public step(Input) path and does not modify health, timing windows, judgments or score behind the rules.

--headless legally completes all six songs at tick 14880, scoring 287675 with all three retry tickets remaining. Track clear ticks are 1945, 4141, 6841, 9025, 11569 and 14857. Suggested graphical smoke captures are frame 420 or 900 for First Spark, frame 2600 for Copper Steps, and frame 13200 for the finale:

cargo run -p voltage-choir --offline --locked -j 2 -- --autoplay --smoke-frames 900 --screenshot target/voltage-choir.png

The bounded model uses at most 768 note slots, six result slots, four musical note-ons and sixteen presentation events per tick. The events record what each tick accepted (hits, misses, empty taps, combo steps, Encore, retries, clears) so effects appear where they happened; rules never read them. Tests cover complete legal concert victory, exact timing boundaries, chords, nearest-note selection, input aliases/holds, missed-note failure, finite retries, Encore costs/expiry, accuracy failure, result accounting, pointer bounds, the Encore meter and End button clicks, header progress, effect emission, note-on lifetime, terminal invariance and repeatability. The rustdoc example executes the pure model without a window. Compilation and headless solutions are not graphical playtests or evidence of physical keyboard, audio-device, mobile, gamepad or cross-platform behavior; parent records those integration checks separately.