This project was created to explore the Mojo programming language and basic emulation. All the emulator logic is written in pure Mojo with basic display and input handling implemented through pygame.
This emulator is far enough along to play simple games like Tetris. And that's about it.
The plan is to slowly continue working on it, to hopefully get more functionality to work, but more importantly, to improve the Mojo metaprogramming aspects. So, for example, I am far less interested in getting audio working than improving the structure and logic of the CPU instructions as I continue to learn more about Mojo and as Mojo adds more metaprogramming features.
The ideal goal: convert the game ROM into Mojo code at compile time 🔥
- CPU Instructions
- Memory Bus
- Basic GPU
- Graphics Display
- Keyboard Input
- Reasonable unit test coverage
- Some potential half carry flag bugs
-
0x8800addressing mode (required for even basic games like Tennis) - MBC Support (required for larger games like Metroid II)
- Audio
You will need to provide your own ROMs.
magic run mojo run ./main.mojo <Boot ROM file> <Game ROM File> [<Pixel Scale Factor>]
So, for example, to run a Tetris (World).gb ROM file at a 4x scale, execute:
magic run mojo run ./main.mojo ./roms/dmg_boot.bin ./roms/Tetris\ \(World\).gb 4
curl -ssL https://magic.modular.com | bash
See Get started with Mojo for more information.