Downbeat: a rhythm game kit for Zero
Notes scroll down a highway and you hit them on the beat. Downbeat is the installable kit for making that kind of game (Guitar Hero, Rock Band, DDR, Beatmania, Taiko no Tatsujin, osu!), and this world is its showcase: play the sample song, flip through every look, calibrate your delay and see your results.
Play the showcase
Press Play and pick a difficulty (easy, normal, hard) for Neon Drive, a 124 BPM synthwave track. Then:
- PLAY, and hit D F J K (or the arrow keys; on a gamepad d-pad left, d-pad down, A, B; on a phone the lane pads appear at the first touch). Esc pauses.
- WATCH DEMO to see the autoplayer hit every note perfectly.
- CALIBRATE to tap along to clicks and then to flashes. Your audio, display and input delay is saved for you on this kind of device.
- Choose a note highway, hit feedback, theme, note speed, hit sounds and the metronome before a song, and switch styles live during one from the dock.
Everyone in the world plays on their own device, judged against their own music and calibration, and everyone sees everyone's score, combo, accuracy and progress.
What the kit gives you
- A beat clock locked to the music that is actually playing. It reads the mixer's own playback position every frame, so notes never drift over a song and a hitch costs one frame.
- A chart format you write by hand (
.rhythmChart): taps, holds, chords, tempo changes and the audio offset. A wrong note is named by its line. - Judgement: Perfect / Great / Good / Miss with early or late in milliseconds, holds held to the end, misses for notes that pass, timing accuracy.
- Latency calibration with a manual offset: +30 ms moves judgement by exactly 30 ms.
- 6 highways: classic vertical, taiko drum track, ring, 3D road, drum circle, one or two lane strip.
- 5 hit feedback styles: big text, target bursts, screen pulse and shake, early/late timing meter, arcade pixel. Combine them.
- 4 themes: neon, pixel, wooden taiko, clean minimal.
- One score, combo, multiplier and grade, kept by scoreKit, with its results card and leaderboard. Keyboard, gamepad and touch lanes come from controlsKit, combo and miss juice from juiceKit, and music, hit sounds and an on-beat metronome play through soundstage.
- A synthesized sample song charted easy, normal and hard, a ready-made song select (
RhythmShowcase), a test suite and two guides.
Install it in your world
Search ZeroMind for downbeat rhythm game kit and install downbeat.package (guid a1dc4e67-a783-4c4e-82b0-4789be718f64). It brings scoreKit, controlsKit, juiceKit and soundstage with it. Then, in a scene entrypoint:
local Rhythm = require("downbeat.rhythm")
local Songs = require("downbeat.songs")
function onLoad()
local song = Songs.get("neonDrive")
Rhythm.play({ chart = song.charts.easy, audio = song.audio, highway = "road", feedback = "text+burst", theme = "neon" })
end
function onUnload()
Rhythm.stop()
end
Or drop the whole showcase into any entity: entity.spawn("Showcase").component.add(asset.resolve("downbeat.RhythmShowcase", "component"), {}).
Two guides ship with it: How to make a rhythm game: notes on the beat, a Guitar Hero style highway, and Build a small rhythm game from start to finish. The package README has the full reference.
Measured
On desktop, playing the hard chart (363 notes) to the end against the music itself, the clock sits within about 3.5 ms of the music's real position on average and does not drift over the song. Calibrated hits land within about 1.5 ms of the beat, and the metronome clicks within about 2 ms. Every highway runs without frames over 50 ms on the hard chart. Browser play has been checked by a person; the browser fix to calibration in 1.0.5 has not yet been re-confirmed there.
Comments · 0
Open discussion, no rating attached. Ask questions, swap notes, follow threads.
Documented parts · 8
- downbeatpackage
- neonDrive.soundClipsoundclip
- neonDrive_easy.rhythmChartrhythmchart
- neonDrive_hard.rhythmChartrhythmchart
- neonDrive_normal.rhythmChartrhythmchart
- rhythmChart.assetTypeassettype
- soundmodule
- synthmodule