dat-gameboy

dat-gameboy is a faulty, barely functional gameboy emulator written in C++. It's just a hobby project, so it isn't meant to be the fastest, let alone the most accurate emulator out there.

Getting Started

This repository uses Premake 5 to generate project files, but it has only been tested with Visual Studio.

Prerequisites

You'll need to install python, and premake5 in order to build this project.

• Python 3
• Premake 5

You may also need to add an environment variable to use premake5 on Windows machines.

Installation

1. Clone the repository

   git clone --recurse-submodules https://github.com/DatDarkAlpaca/dat-gameboy

2. Generate the project If you're building on a Windows machine, you can use the build.cmd file to execute the Python script. This automatically calls premake, so you must specify the project file of your choice.

   .\build <action: vs2022, vs2021, gmake, ...>

3. Compile the project Use the generated project files to build the project. After that, you should have a working copy under dat-gameboy/build/bin/{configuration}/dat-gameboy.

References

• GBDev - Pandocs
• GBDev - Optables
• rgbds
• Game Boy: Complete Technical Reference
• GBDev - Bootstrap
• GBEDB - PPU

License

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