Welcome to the Simple Monochrome GameBoy Emulator! This project is a straightforward C++ emulator aimed at simplicity and ease of understanding, making it ideal for learning about emulation concepts or experimenting with GameBoy development.
- Easy-to-Understand Code: The emulator is designed with clarity in mind, with extensive comments throughout the codebase to explain its functionality.
- Controller Support: Supports xbox and PS controller as well as keyboard, click here for mapping.
| Action | Keyboard | PlayStation Controller | Xbox Controller |
|---|---|---|---|
| Move Right | → | D-Pad Right | D-Pad Right |
| Move Left | ← | D-Pad Left | D-Pad Left |
| Move Up | ↑ | D-Pad Up | D-Pad Up |
| Move Down | ↓ | D-Pad Down | D-Pad Down |
| Button A | V | ╳ | A |
| Button B | C | ◯ | B |
| SELECT | Z | Select | Back |
| START | X | Start | Start |
This can simply be done by downloading the executable under Releases. I've also included the necessary dll's which will need to be in the same folder. Simply drag a rom file into the window and the game will start up. Enjoy!
Ensure you have SDL2 installed on your system. Follow the instructions below based on your operating system:
- Download the SDL2 development libraries for Visual Studio from here. It will be named similar to 'SDL2-devel-X.XX.X-VC.zip'.
- Extract the downloaded files and copy the contents to the gbEmu directory where all the source files are located.
- Rename the folder to SDL2.
This emulator was developed and tested primarily in Visual Studio on Windows. While it may require minor adjustments, it should be relatively easy to adapt for other operating systems. Feel free to experiment and contribute to make it more compatible across different platforms since no compiler/platform specific code is used.
The emulator supports the following Memory Bank Controllers (MBCs):
- No MBC
- MBC1
- MBC2
- MBC3
- MBC5
- MBC6
- MBC7
- MMM01
- M161
- HuC1
- HuC-3
Most of these are for other gameboy models anyway so they aren't relavent here anyway.
Welcome! I'm thrilled that you're interested in contributing to our project. Collaboration is at the heart of what we do, and we value the unique perspectives and skills that each contributor brings to the table.
Contributing is easy! Here's how you can get started:
- Fork the repository to your GitHub account.
- Make your desired changes or additions.
- Commit your changes and push them to your fork.
- Submit a pull request with a clear description of your changes.
This project is licensed under the GNU GENERAL PUBLIC LICENSE - see the LICENSE file for details.
Please note that this project is created by myself and is not affiliated with or endorsed by Nintendo. All trademarks, registered trademarks, product names, and company names mentioned herein are the property of their respective owners.