Skip to content

Latest commit

 

History

History
39 lines (24 loc) · 1.32 KB

readme.md

File metadata and controls

39 lines (24 loc) · 1.32 KB

Welcome to Alchemy.

A Game Boy Emulator Written In Go.

Alchemy is a complete emulator of the 1989 Game Boy. It is written from scratch in Go. Currently, Alchemy is able to run all 32 KB roms such as Tetris, Dr. Mario, Asteroids and Tennis.

Installation

In order to run Alchemy, you will need to clone the repository and then compile the source code. You can do so by running the following commands.

git clone https://github.com/shafinsiddique/alchemy
cd alchemy/src/alchemy
go build -o alchemy
./alchemy

Controls

- Left Arrow
- Right Arrow
- Up Arrow
- Down Arrow
- Space for 'Select'
- Enter for 'Start'
- A for 'a'
- S for 'b   

Testing

Currently, Alchemy passes all of Blargg's CPU Instruction Tests.

The PPU passes all parts of the DMG-Acid2 Test except for the Window section due to the window layer not being implemented yet.

Acknowledgements

This emulator could not have been completed without the support and 24/7 help from the amazing people on the Emulation Development Discord Server. If you're building an emulator, i highly suggest you check this community out.