Home

Awesome

GBDK-2020

GBDK is a cross-platform development kit for sm83, z80 and 6502 based gaming consoles. It includes libraries, toolchain utilities and the SDCC C compiler suite.

Supported Consoles: (see docs)

Experimental consoles (not yet fully functional)

Current Release

Current Release Downloads

<a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-linux64.tar.gz"><img src="https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="GBDK-2020 Linux Release"></a> <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-macos.tar.gz"><img src="https://img.shields.io/badge/mac%20os%20intel-000000?style=for-the-badge&logo=apple&logoColor=white" alt="GBDK-2020 MacOS Intel Release"></a> <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-macos-arm64.tar.gz"><img src="https://img.shields.io/badge/mac%20os%20arm%20(m*)-000000?style=for-the-badge&logo=apple&logoColor=white" alt="GBDK-2020 MacOS ARM Release"></a> <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-win64.zip"><img src="https://img.shields.io/badge/Windows%2064%20Bit-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="GBDK-2020 Windows 64 Bit Release"></a> <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-win32.zip"><img src="https://img.shields.io/badge/32%20Bit-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="GBDK-2020 Windows 32 Bit"></a>

<!-- <a href="https://hub.docker.com"><img src="https://img.shields.io/badge/Docker-2CA5E0?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a> -->

Upgrading to a new version? Check the Migration notes. You can find older versions here.

For a full list of changes see the ChangeLog file or online Docs.

Build status

GBDK Build and Package

Made with GBDK-2020

See our gallery showcasing Games and Programs made with GBDK

Docs

GBDK includes extensive documentation. A good place to begin is the Getting Started Section.

Check the Links and Third-Party Tools Section for a list of recommended emulators, graphics tools, music drivers and more.

For SDCC you can check its website and the manual

Usage

Most users will only need to download and unzip the latest release

Then go to the examples folder and build them (with compile.bat on Windows or running make). They are a good starting point.

The sources in this repo are only needed if you want to re-compile GBDK-2020 yourself instead of using the release binaries linked above.

Discord servers

Forums

Current status

Origin

Over the years people have been complaining about all the GBDK issues caused by a very old version of SDCC (the compiler). This is a proper attempt of updating it while also keeping all the old functionality working, like support for banked code and data and so on.

The last version in the OLD repo is 2.96 although releases are available until 2.95-3. Version 2.96 is the starting point of this repo.

Build instructions

Unless you are interested on recompiling the sources for some reason (like fixing some bugs) you don't need to build GBDK