Awesome Game Boy Development

A curated list of awesome Game Boy (Color) Development resources, tools, docs, related projects and homebrews. Inspired by the awesome list thing.

This project is open source and community-lead. Come contribute!

Chat with the community!

# Introduction

# The Game Boy, a hardware autopsy (opens new window)



# The Ultimate Game Boy Talk (opens new window)



# Disambiguation

# Game Boy Advance

Game Boy Advance development is covered by another project, the awesome-GBAdev (opens new window) list. GBA, however, can run GB/GBC games. It does so in a slightly different way compared to native hardware. This is covered in the Emulator Development section of this list.

# Game Boy Color and Super Game Boy

This list is focused on the original (1989) Game Boy (DMG), the Game Boy Color (GBC) and Super Game Boy (SGB) are very similar systems, with a few important distinctions, such as:

  • Different hardware specifications
  • Specific hardware and software features
  • Specific registers
  • Specific bugs, quirks and exploitable behaviours

If you aim to develop your software for SGB or GBC, or you want to know how it runs on the other systems, you may want to take advantage and adapt to these differences, check the Game Boy Color category and look for specific references to GBC/CGB and SGB.

# Documentation

# Opcodes

# Game Boy Color

# Hardware

# Peripherals

# Cartridges

# Custom cartridges

# Misc

# Emulator Development

# Testing

# Software Development

The To C Or Not To C (opens new window) essay gives an overview of the Game Boy's capabilities, discussing the pros and cons of the available development tools, and providing tips to write more efficient code.

# Assemblers

# Compilers

  • GBDK (opens new window) - A set of tools that enable to develop in C. Includes a set of libraries for the most common requirements and generates ready ROM files. Last updated in 2001. Documentation (opens new window).
    • GBDK-2020 (opens new window) - A modernized GBDK with updated SDCC toolchain (supports ROM banking), bug fixes, documentation and other improvements. Supports Windows, Linux and MacOS.
    • gbdk-osx (opens new window) - Patched GBDK 2.96a for the latest compilers on macOS.
    • gbdk-n (opens new window) - Aims to update the gbdk libraries to be compatible with new versions of SDCC and provide helpers for building roms. Does not support ROM banking, thus limiting ROM size to 32K.

# Experimental/Proof of Concepts

# Emulators

Complete list of open source emulators

# Tools

# Engines

# Development tools

# Graphics utilities

# Hardware and ROM utilities

# Music drivers and trackers

# Programming

Guides, tutorials and tools to develop software for Game Boy using the development toolchains described in the Software Development chapter.

# ASM

# Sources

Fragments of code, effects, proof of concepts and generally non complete games.

# Timings

# Boilerplates and libraries

# Syntax highlighting packages

# C

# Homebrews

Complete and open source games.

  • Homebrew Hub (opens new window) - Every unofficial homebrew ever produced for Game Boy playable online (mobile/touch too): a community-lead attempt to collect, archive and save every unofficial game, homebrew, demo, patch, hackrom for Game Boy (Color) produced by the community through years of passionate work.
  • Infinity (opens new window) - RPG developed by Affinix Software primarily between the years 1999 and 2001. The game never found a publisher and was eventually canceled. Got recently released with the full source, development tools and workflows.

# ASM

# C

# Demos

# Reverse Engineering

# Game Disassemblies

# Directories

# Websites

Game Boy is a registered trademark. This project is not endorsed by Nintendo.
© 2015-2021 gbdev contributors.