MegaBoy

MegaBoy, a cross-platform accurate Gameboy/Color emulator made in C++

Getting Started

1. Open the web version and try online Here, or download desktop build from Releases
2. Drag and Drop ROM file into the window, or select ROM file using File → Load
3. Play!

Default Controls

Gameboy Key A X B Z Up ↑ Down ↓ Left ← Right → Start Enter Select Backspace

Emulator Key Pause Tab Restart R Fast Forward Space Screenshot T Save State Alt + 1-9 Load State Shift + 1-9 Quick Save Q Quick Load `

All controls are remappable in the settings!

Screenshots

Debugger

Features

• Cycle-accurate SM83 CPU emulation
• Cycle-accurate PPU emulation
• Experimental audio emulation
• Built-in GUI with debugger
• Gameboy Color support
• Boot ROM support - simply drag and drop or open file dmg_boot.bin (cgb_boot.bin for gameboy color)
• Supports running DMG games in CGB mode (with unique palettes using cgb_boot.bin) and CGB games in DMG mode
• Mappers: MBC1, MBC2, MBC3, MBC5, MBC6, HuC1, HuC3
• MBC3 and HuC3 include Real-Time Clock
• Battery save support (.sav files), compatible with other emulators like SameBoy
• Save state support (.mbs files), allowing you to resume any game from the exact point you left off
• Persistent battery and save states even in the web version, so you won't lose your progress
• Game Genie and Game Shark cheats (Emulation → Enter Cheat)
• Can load zipped ROMs
• Can take game screenshots (Saved in screenshots folder near the emulator executable)
• Fast-forwarding
• Shader support (LCD, upscaling, GBC color correction); Configurable DMG palette

Compatibility

Although complete accuracy was not a goal for this emulator, it's still very accurate (passing all mooneye-gb DMG/CGB tests except intr_2_mode0_timing_sprites.gb). This allows it to play games like Pinball Deluxe and Prehistorik Man, known to have issues in many other emulators.

I tested many games while developing this emulator, and as of now, all games I tried work correctly, aside from some audio glitches in a few games, which will be fixed in the future updates. If you find a game that doesn’t work, feel free to open an issue, and I will look into it.

Building

This project uses CMake as build system, allowing it to be build for different platforms without issues.

1. Use git clone --recursive https://github.com/MeGaL0DoN/MegaBoy to clone the project. Note: regular clone or GitHub "Download ZIP" option won't work, as project includes submodules.
2. After cloning the repository, make sure that you have CMake installed, and then you can either:
   • Go inside the project directory and run the CMake command line tool, or
   • Open and build the project in an IDE that supports CMake (such as Visual Studio or CLion).
3. Note: to build for the web, you need the Emscripten toolchain installed, and must configure CMake to use it.

Upcoming Features

Planned Features

• Improve accuracy of the audio emulation
• Add MBC6, MBC7, HuC-3
• Add gamepad support

Maybe Features

• Super Game Boy
• Online Multiplayer
• Mobile-Friendly web interface

Resources Used

It wouldn't be possible to make MegaBoy without these resources:

• Pan Docs: https://gbdev.io/pandocs/
• Gbops opcode table: https://izik1.github.io/gbops/
• RGBDS CPU opcode reference: https://rgbds.gbdev.io/docs/v0.9.0/gbz80.7
• SM83 SingleStepTests by originaldave_: https://github.com/SingleStepTests/sm83
• NightShade's Sound Emulation: https://nightshade256.github.io/2021/03/27/gb-sound-emulation.html
• EmuDev discord server! https://discord.gg/dkmJAes

Libraries

• GLFW - Window management and input.
• glad - Used to load OpenGL functions.
• ImGui - User interface.
• miniaudio - Audio.
• mINI - INI file writer.
• miniz - Zip compression/decompression.
• nativefiledialog-extended - Cross platform (desktop) file dialogs.
• emscripten_browser_file - File dialog for the web.
• emscripten_browser_clipboard - Clipboard management for the web.

License

This project is licensed under the MIT License - see the LICENSE.md file for details