https://github.com/nekronos/gbc_rs

GameBoy Color emulator written in Rust
https://github.com/nekronos/gbc_rs

emulator rust

Last synced: 8 days ago
JSON representation

GameBoy Color emulator written in Rust

• Host: GitHub
• URL: https://github.com/nekronos/gbc_rs
• Owner: nekronos
• License: mit
• Created: 2016-08-23T07:55:31.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-19T18:37:39.000Z (7 months ago)
• Last Synced: 2025-04-03T10:11:13.012Z (about 2 months ago)
• Topics: emulator, rust
• Language: Rust
• Homepage:
• Size: 668 KB
• Stars: 33
• Watchers: 5
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gbc_rs

![tests](tests.png)

![game](game.png)

A GameBoy Color emulator written in the Rust programming language.

The purpose of this emulator is solely for me to learn Rust and to learn about how to write emulators.

This emulator is in development and is far from complete. So far it has basic functionality and can run DMG games using MBC1 and MBC3.

### Build & Run

* `cargo run --release rom.gb`

### Controls

| GameBoy button  | Keyboard      |

| --------------- | ------------- |

| A               | Space         |

| B               | Left Control  |

| Start           | Return        |

| Select          | Right Shift   |

| Up              | Up            |

| Down            | Down          |

| Left            | Left          |

| Right           | Right         |

### Resources used

- [Zilog Z80 user manual](http://www.zilog.com/docs/z80/um0080.pdf)

- [Game Boy Programming Manual](http://www.romhacking.net/documents/544/)

- [Pan Docs](http://bgb.bircd.org/pandocs.htm)

- [blargg's gb tests](http://gbdev.gg8.se/files/roms/blargg-gb-tests/)

- [gbdev wiki](http://gbdev.gg8.se/wiki/articles/Main_Page) 

- [LR35902 opcode table](http://pastraiser.com/cpu/gameboy/gameboy_opcodes.html)

- [BGB and its excellent debugger](http://bgb.bircd.org/)