Brick Boy

WIP Game boy emulator

Building

You will need cmake, make and a C compiler (GCC or Clang).

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make

Running

./brickboy <rom.gb>

Controls

• W A S D - D-Pad
• RShift - Select
• Enter - Start
• J - A
• K - B

Hotkeys

• F1 - Toggle debug view
• F2 - Change color palette
• F12 - Take screenshot
• Esc - Quit

Status

• CPU
• Timer
• Background
• Window
• DMA
• Sprites 8x8
• Sprites 8x16
• Scrolling
• Sound
• Input
• Mappers
• Boot ROM
• Battery save

CPU tests (Blargg's)

• 01-special
• 02-interrupts
• 03-op sp,hl
• 04-op r,imm
• 05-op rp
• 06-ld r,r
• 07-jr,jp,call,ret,rst
• 08-misc instrs
• 09-op r,r
• 10-bit ops
• 11-op a,(hl)

Tested Games

Game	Status	Notes
Battletoads Double Dragon - The Ultimate Team	Playable
Contra: The Alien Wars	Playable
Darkwing Duck	Playable
Donkey Kong Land 3	Has issues	Colors are inverted
Dr. Mario	Playable
Duck Tales 2	Playable
Kirby's Dream Land	Playable
Super Mario Land	Playable
Super Mario Land 2: 6 Golden Coins	Crashes
Tetris	Playable
The Legend of Zelda: Link's Awakening	Playable
V-Rally - Championship Edition	Playable

Resources

• Pan Docs
• CPU Manual
• The Ultimate Game Boy Talk (Video) by Michael Steil
• Opcodes Table by meganesu
• Gameboy Logs by wheremyfoodat
• Test ROMs (mirror of Blargg’s tests)
• The Gameboy Emulator Development Guide by Hacktix
• Bootix - DRM-free Gameboy boot ROM by Hacktix
• Lazy Gameboy Emulator by CTurt
• Gameboy Palettes by TheWolfBunny64