A ball bounces from side to side, hit it before it leaves the screen to score a point!
Start Game: Start
Left-Hit: D-Pad Left
Right-Hit: A
The latest version of metronome.gb can be found here.
You will need a Game Boy emulator like BGB, SameBoy to run the game.
Written to be built with RGBDS 1.0.1 or newer, which must be installed before building.
A build script is included, src/build.sh, that will build a game directory. The metronome.gb file can be found in the game directory.
Automated emulator smoke tests use PyBoy and are managed with uv:
uv run pytestThe tests build the ROM, compare the title screen with the reference frame in demo/metronome.gif, press Start, and verify that gameplay begins. SameBoy is still recommended for final manual checks of audio and gameplay.
This game was a project for me to learn some Game Boy ASM development basics, the scope is tiny and the code is likely very poorly optimised.
Game Boy Development Community - This is a great collection of documents, tools and community links for Game Boy Development
I highly recommend the Gingerbread library and its associated book, "Game Boy Assembly Programming for the Modern Game Developer."
This Gingerbread library provides some very useful boilerplate code such as defining various constants and low-level functions, takes care of the boot process and the ROM header, and when combined with the tutorials in "Game Boy Assembly Programming for the Modern Game Developer" they made this process much easier than I was expecting.