gb/README.md

1.2 KiB

Rekai's Gameboy Emulator

Status

  • From Blargg Test ROMs
    • cpu_instrs
    • instr_timing
    • mem_timing
    • mem_timing-2
    • dmg_sound (partial)
  • dmg-acid2
  • From mooneye-gb:
    • Cartridges:
      • MBC1
      • MBC1M
      • MBC2
      • MBC5
  • Implements a cycle-accurate PPU FIFO
    • Doesn't *exactly* work just yet

Supports: ROM-only, MBC1, MBC2, MBC3 and MBC5 games.

Compiling

This project was last successfully built on Rust 1.64.0

  1. git clone https://github.com/paoda/gb
  2. cd gb
  3. cargo run --release

Controls

Controls are defined here

Key Button
X B
Z A
Enter START
Shift SELECT

Then use the Arrow keys for the D-Pad

Credits

The Boot ROM found in the bin/ directory was made by Optix over here