Mizu

Mizu 是一个使用 Rust 编写的准确 Gameboy 仿真器。

特性

• 仿真原始 gameboy（DMG）和 gameboy color 硬件。
• 通过大多数硬件测试（见 TESTING.md）。
• 更好的保存支持。
• 控制 SRAM 保存文件，并能够禁用 SRAM 保存。
• MBC3 映射器精确的 RTC 仿真。
• 带有 48KHz 音频的精确 APU 仿真。
• SFML 图形用户界面。
• 强大的测试框架，用于持续测试。
• 轻松更改仿真速度。
• 功能映射器
  • NoMapper
  • MBC1
  • MBC2
  • MBC3
  • MBC5
• 打印机仿真
• 保存状态

控制

SFML 前端提供以下键盘绑定

Gameboy

额外

* 我创建这个功能是因为在 Zelda: Link's awakening 中，需要在同一帧上按这些按钮来打开保存菜单，这很烦人。

** 这里的 FPS 与正常游戏的 FPS 不同，低 FPS 只会使游戏卡顿，这里的 FPS 控制仿真速度。通常它会以 60 FPS 运行。如果用户将 FPS 设置为 30，则仿真速度减半，包括音频和 CPU 仿真。

打印机窗口键

打印机

Gameboy 打印机是一种串行设备，可以连接到 gameboy，并被一些卡带用于打印图像。使用它的流行卡带包括

• Gameboy Camera。
• Zelda: Link's Awakening DX（用于从相册打印图像）。
• Pokemon（几个版本）（用于从口袋妖怪图鉴打印口袋妖怪信息）。

通过按 P 键可以打开打印机。

打印机仿真允许将打印的图像保存到磁盘。窗口只会显示 160x144 像素，但图像可以滚动。

保存状态

保存状态是仿真器应具备的非常有用的功能，它允许在任何时间点保存整个仿真器的状态，并在以后任何时候加载。 mizu 的保存状态文件保存在这些文件夹中

Linux:   /home/<user>/.local/share/mizu/saved_states
Windows: C:\Users\<user>\AppData\Local\Amjad50\Mizu\data\saved_states
macOS:   /Users/<user>/Library/Application Support/Amjad50.Mizu/saved_states

保存文件的版本结构为 2

文件版本之间没有迁移（除了从 1 到 2），这意味着从仿真器旧版本保存的文件将无法在仿真器的新版本中加载。（如果您有任何关于如何实现这一点的建议，欢迎您提交PR。）

使用 hash 确保我们正在加载同一款游戏。

zstd 压缩出现在版本 2 中，这也是我们可以通过解压缩加载版本 s 的原因。压缩内容是通过使用 save_state 库获得的。

$ cargo build

$ cargo build --release

$ cargo install mizu