GBDK A C compiler, assembler, linker and set of libraries.
Supported Consoles:
- Nintendo Gameboy
- Sega Master System & Game Gear
Upgrading to a new version? Check the Migration notes. You can find older versions here.
- updated CRT and library that suits better for game development
- the latest nightlies of sdcc (the compiler and toolchain) are used from sourceforge. At the moment of writing this the last stable version is 4.1.0, which is missing features from newer SDCC builds that GBDK-2020 uses. Please use one of the nightlies available here (we used 4.1.6 #12439)
- The compiler driver lcc supports the latest sdcc toolchain.
For full list of changes see the ChangeLog file
Online documentation is avaliable HERE
A good place to start 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.
Over the years people have been complaining about all the 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 functionallity 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
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.
- gbdk/zgb Discord - For help with using GBDK (and ZGB), discussion and development of gbdk-2020
- gbdev Discord - There is a #gbdk channel and also people with a lot of Game Boy development knowledge
For SDCC you can check its website and the manual
The Game Boy Development Forum is a good place to search for answers.
Unless you are interested on recompiling the sources for some reason (like fixing some bugs) you don't need to build GBDK
- Windows only: Download and install mingw
- Clone, download this repo or just get the source form the releases
- Download and install sdcc nightlies from 4.1.6 #12439 onwards (SDCC is no longer part of GDDK so you need to download it (just the binaries) in the platform you need)
- On Linux don't use package managers The latest release available won't work, you need to compile or download one of the nightlies
- Create SDCCDIR environment variable, that points into the folder, where you installed sdcc
- Open command prompt or a terminal, go to the root directory of the repo and run make