/rust-gameboy

A non-std rust library that emulates the GameBoy Color's Z80-like CPU and its peripherals.

Primary LanguageRust

Rust Gameboy emulation crate

Build

A rust crate that emulates the GameBoy/GameBoy Color's Z80-like CPU and its peripherals, without using rust's standard library (making it suitable for embedded environments).

The crate is currently almost capable of fully running MBC3 classic gameboy games.

Running

In order to run the example emulator, type:

cargo run --features="display" --example emulator <rom-path>

Key bindings: Arrow keys; Enter, Space, Z and X (for START, SELECT, A and B, respectively).

References

I'm using Pan Docs, the Cycle-accurate Game Boy docs, the Game Boy: Complete Technical Reference, and the GameBoy CPU Manual as references for the emulation library's development.

Disclaimer

GAME BOY is a trademark of Nintendo Co., Ltd.

This project was made entirely for fun and non-profit purposes, and for getting experienced in rust.