2 个版本

0.10.7	2024年8月8日
0.10.5	2024年8月8日

#91 在模拟器

238 每月下载量
在 Boytacean 中使用

Apache-2.0

25KB
652 行

Boytacean

用 Rust 编写的 Game Boy 模拟器 🦀。

这个模拟器是为教育目的编写的，不应该太认真对待。 但是，它确实可以玩大多数 Game Boy 游戏，这很酷... 🕹️

功能

Game Boy (DMG) 和 Game Boy Color (CGB) 模拟
简单的可导航源代码
Web、SDL 和 Libretro 前端
音频，具有相当准确的 APU
支持串行数据传输（《Link Cable》）
Game Boy 打印机模拟
支持多个 MBC：MBC1、MBC3 和 MBC5
使用 BESS 规范支持使用保存状态，与其他模拟器跨兼容
使用 Game Genie 和 GameShark 代码支持作弊
可变 CPU 时钟速度
准确的 PPU - 通过 dmg-acid2 和 cgb-acid2 测试

对于 Web 前端...

以移动设备为先的设计体验
使用 Web 存储 API 进行透明的 RAM 保存
使用 Web 游戏手柄 API 支持游戏手柄
无干扰且有效的屏幕游戏手柄
震动模拟和触觉反馈
由 TheWolfBunny64 构建的独特的显示调色板。
全屏浏览器模式
调试模式 - VRAM 和寄存器

仍然缺少...

低级周期精确的系统模拟
《Game Boy Camera》模拟
NetPlay 游戏支持

部署

提供商	稳定	URL
Cloudflare	`真`	boytacean.joao.me
Cloudflare	`真`	boytacean.pages.dev
Cloudflare	`真`	prod.boytacean.pages.dev
Cloudflare	`真`	stable.boytacean.pages.dev
Cloudflare	`假`	master.boytacean.pages.dev

构建

库

cargo build

Python 库

pip install .

或

python setup.py install

Node.js 的 WASM

cargo install wasm-pack
wasm-pack build --release --target=nodejs -- --features wasm

Web 的 WASM

cargo install wasm-pack
wasm-pack build --release --target=web --out-dir=frontends/web/lib -- --features wasm
cd frontends/web
npm install && npm run build
cd dist && python3 -m http.server

Web 前端

Web 前端使用了 EmuKit，这是一个 UI 工具包，为在 Web 环境中创建仿真界面提供了所需的底层基础设施。

配置

您可以使用一些 GET 参数来控制仿真器的初始行为。

参数	类型	描述
`rom_url`	字符串	要加载初始 ROM 的 URL，应支持 CORS。
`url`	字符串	与 `rom_url` 相同。
`fullscreen`	布尔值	如果仿真器应以全屏模式启动。
`fs`	布尔值	与 `fullscreen` 相同。
`debug`	布尔值	如果“调试器”应以可见状态启动，并在 `verbose` 模式下显示信息。
`verbose`	布尔值	如果应以 verbose 模式显示信息。
`keyboard`	布尔值	如果应启动可见的屏幕键盘。
`palette`	字符串	启动时设置的调色板名称（例如：`christmas`，`hogwards`，`mariobros` 等）。

调色板

Web 版本中提供的调色板由 TheWolfBunny64 提供。

灵感

要获取关于通过仿真创建过程启发的资源的更多信息，请查看灵感。

贡献

喜欢 Gameboy 仿真吗？想为 Boytacean 贡献？这很棒！您的贡献是使开源社区成为如此令人惊叹的学习、灵感和创作之地的原因。

要开始，请查看我们的贡献指南。无论您是在修复错误、添加新功能还是帮助编写文档，每一项贡献都是有价值的，并且非常受欢迎！

如果您有任何问题，请不要犹豫，与我们联系。加入我们，让 Boytacean 成为最好的 Gameboy 仿真器！

boytacean-encoding