v1.0.0-alpha

This is the first public release of ZigBoy, a Gameboy (DMG) emulator written from scratch in Zig.

Features

• CPU Emulation: Implements the full SM83 instruction set.
• PPU Rendering: Supports background tiles, window, and sprites.
• Cartridge Support: Playable support for ROM-only and MBC1 cartridges.

Compatibility

The following games have been tested and are confirmed to be playable:

• Tetris
• The Legend of Zelda: Link's Awakening
• Super Mario Land

Known Issues

This is an early release and still has many bugs. Please be aware of the following issues:

• APU is unstable: The audio processing unit (APU) is implemented but has bugs that cause incorrect sound. It is disabled by default.
• Performance Drop: Enabling the APU via build flags (-Denable_apu=true) will cause a significant performance drop to around 40-50 FPS.
• Limited ROM Support: Attempting to run games other than those listed above panics.

Controls

The emulator uses the keyboard for input. The default key mappings are:

Keyboard Key	Gameboy Button
W, A, S, D	D-Pad (Up, Left, Down, Right)
Z	A Button
X	B Button
Enter	Start Button
P	Select Button
Escape	Quit Emulator