Skip to content

Latest commit

 

History

History
44 lines (29 loc) · 2.04 KB

README.md

File metadata and controls

44 lines (29 loc) · 2.04 KB

GB-8

GitHub GitHub Release Date GitHub last commit GitHub repo size

What's this?

GB-8 is a CHIP-8 interpreter for the Gameboy Color. It comes pre-loaded with a whole bunch of CHIP-8 ROMs and is easily expandable and modular. And thanks to the small size of CHIP-8 ROMs, it even fits onto a 32KB cartridge!

How do I use it?

Simply download the newest version from the Releases Section and load it up on hardware or on your favorite Gameboy emulator. You'll be shown a menu which you can navigate using the D-Pad. Once you've selected the game you want to play, press A or Start in order to start the emulator. If you want to quit out of the game, pressing the buttons A, B, Start and Select all at the same time exits the emulator.

Controls for the games themselves are mapped on a per-game basis, most should be quite intuitive though.

Which ROMs are there?

The current Release build comes packaged with the following ROMs:

  • Airplane (Game)
  • AstroDodge (Game)
  • Blinky (Game)
  • Breakout (Game)
  • Cave (Game)
  • Kaleidoscope (Demo)
  • Particle (Demo)
  • Pong (Game)
  • Sierpinski (Demo)
  • Trip8 (Demo)
  • Fall (Demo)

If you clone the repository you can add your own CHIP-8 ROMs and assemble a new GB ROM, all you need to do is to change the src/roms.asm file to your needs. A description of the file format can be found at the top of the file.

What does it look like?

Except for the menu parts of the emulator, it's simply just a common CHIP-8 display. For convenience, the emulator scales the screen up by a factor of 2, so that things are visible without having to squint at them.

But it's probably best to see for yourself:

Pong

Breakout