Gameboy

全功能的跨平台 GameBoy 模拟器。 永远属于男孩们！

您可以使用以下命令开始游戏。以下示例使用内置游戏 "SUPER MARIOLAND"。

$ cargo run --release -- "./res/sml.gb"

以下选项受支持

-a, --enable-audio    Enable audio, default is false
-x, --scale-factor    Scale the video by a factor of 1, 2, 4, or 8

Gameboy 使用 Rust 开发，已在 Windows、Ubuntu 和 Mac 上进行了彻底测试。

依赖项

此项目依赖于以下 Rust 库，它们具有原生依赖项

• cpal
• minifb

在运行此模拟器之前，您可能需要安装这些库所需的原生依赖项。

对于 Ubuntu Linux，您可以运行

sudo apt install libasound2-dev # Install CPAL dependencies
sudo apt install libxkbcommon-dev libwayland-cursor0 libwayland-dev # Install MiniFB dependencies

对于 Windows，您应安装 Microsoft C++ Build Tools。

控制

                _n_________________
                |_|_______________|_|
                |  ,-------------.  |
                | |  .---------.  | |
                | |  |         |  | |
                | |  |         |  | |
                | |  |         |  | |
                | |  |         |  | |
                | |  `---------'  | |
                | `---------------' |
                |   _ GAME BOY      |
   Up           | _| |_         ,-. | ----> Z
Left/Right <--- ||_ O _|   ,-. "._,"|
  Down          |  |_|    "._,"   A | ----> X
                |    _  _    B      |
                |   // //           |
                |  // //    \\\\\\  | ----> Enter/BackSpace
                |  `  `      \\\\\\ ,
                |________...______,"

测试

感谢 Blargg 的 Gameboy 硬件测试 ROM，我可以轻松验证我的代码。使用以下命令运行测试

$ cargo run --example blargg

测试名称	结果
cpu_instrs
instr_timing

参考

• Gbdev
• 开放 Game Boy 文档项目
• LR35902 指令集
• LR35902 指令集表
• Game Boy 内存映射
• Game Boy 技术数据
• awesome-gbdev
• MBC ROM 列表
• ROM 下载

许可证

MIT。