Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maxpoletaev/brickboy
Gameboy emulator in good old C
https://github.com/maxpoletaev/brickboy
Last synced: about 1 month ago
JSON representation
Gameboy emulator in good old C
- Host: GitHub
- URL: https://github.com/maxpoletaev/brickboy
- Owner: maxpoletaev
- License: mit
- Created: 2023-12-03T13:18:01.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-04-27T17:19:28.000Z (8 months ago)
- Last Synced: 2024-04-27T18:30:09.014Z (8 months ago)
- Language: C
- Homepage:
- Size: 253 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Brick Boy
WIP Game boy emulator
## Building
You will need `cmake`, `make` and a C compiler (GCC or Clang).
```bash
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make
```
## Running
```bash
./brickboy
```
## 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
* [x] CPU
* [x] Timer
* [x] Background
* [x] Window
* [x] DMA
* [x] Sprites 8x8
* [x] Sprites 8x16
* [x] Scrolling
* [ ] Sound
* [x] Input
* [x] Mappers
* [x] Boot ROM
* [x] Battery save
## CPU tests (Blargg's)
- [x] 01-special
- [x] 02-interrupts
- [x] 03-op sp,hl
- [x] 04-op r,imm
- [x] 05-op rp
- [x] 06-ld r,r
- [x] 07-jr,jp,call,ret,rst
- [x] 08-misc instrs
- [x] 09-op r,r
- [x] 10-bit ops
- [x] 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](https://gbdev.io/pandocs/)
- [CPU Manual](http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf)
- [The Ultimate Game Boy Talk](https://www.youtube.com/watch?v=HyzD8pNlpwI) (Video) by Michael Steil
- [Opcodes Table](https://meganesu.github.io/generate-gb-opcodes/) by meganesu
- [Gameboy Logs](https://github.com/wheremyfoodat/Gameboy-logs) by wheremyfoodat
- [Test ROMs](https://github.com/retrio/gb-test-roms) (mirror of Blargg’s tests)
- [The Gameboy Emulator Development Guide](https://hacktix.github.io/GBEDG/) by Hacktix
- [Bootix - DRM-free Gameboy boot ROM](https://github.com/Hacktix/Bootix) by Hacktix
- [Lazy Gameboy Emulator](https://cturt.github.io/cinoop.html) by CTurt
- [Gameboy Palettes](https://www.deviantart.com/thewolfbunny64/gallery/69987002/game-boy-palettes) by TheWolfBunny64