git.y1.nz

gbdk-2020

GameBoy Development Kit
download: https://git.y1.nz/archives/gbdk.tar.gz
README | Files | Log | Refs | LICENSE

README.md

      1 # GBDK-2020
      2 GBDK is a cross-platform development kit for sm83, z80 and 6502 based gaming consoles. It includes libraries, toolchain utilities and the [SDCC](http://sdcc.sourceforge.net/) C compiler suite.
      3 
      4 __Supported Consoles:__ [(see docs)](https://gbdk.org/docs/api/docs_supported_consoles.html)
      5 - Nintendo Game Boy / Game Boy Color
      6 - Analogue Pocket
      7 - Sega Master System & Game Gear
      8 - Mega Duck / Cougar Boy
      9 - NES
     10 
     11 Experimental consoles (not yet fully functional)
     12   - MSXDOS
     13 
     14 
     15 ## Current Release
     16 
     17 [![Current Release](https://img.shields.io/github/v/release/gbdk-2020/gbdk-2020?label=Current%20Release)](https://github.com/gbdk-2020/gbdk-2020/releases/latest)
     18 ![Downloads](https://img.shields.io/github/downloads/gbdk-2020/gbdk-2020/total?label=Total%20Downloads)
     19 
     20 <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-linux64.tar.gz"><img src="https://img.shields.io/badge/Linux%20Intel-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="GBDK-2020 Linux Intel Release"></a>
     21 <a href="https://github.com/gbdk-2020/gbdk-2020/releases/download/4.4.0/gbdk-linux-arm64.tar.gz"><img src="https://img.shields.io/badge/Linux%20ARM-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="GBDK-2020 Linux ARM Release"></a>
     22 <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-macos.tar.gz"><img src="https://img.shields.io/badge/mac%20intel-000000?style=for-the-badge&logo=apple&logoColor=white" alt="GBDK-2020 MacOS Intel Release"></a>
     23 <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%20arm%20(m*)-000000?style=for-the-badge&logo=apple&logoColor=white" alt="GBDK-2020 MacOS ARM Release"></a>
     24 <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> 
     25 <a href="https://github.com/gbdk-2020/gbdk-2020/releases/latest/download/gbdk-win32.zip"><img src="https://img.shields.io/badge/Windows%2032%20Bit-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="GBDK-2020 Windows 32 Bit"></a> 
     26 
     27 <!-- <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> -->
     28 
     29 Upgrading to a new version? Check the [Migration notes](https://gbdk.org/docs/api/docs_migrating_versions.html). You can find older versions [here](https://github.com/gbdk-2020/gbdk-2020/releases).
     30 
     31 For a full list of changes see the [ChangeLog](https://github.com/gbdk-2020/gbdk-2020/blob/master/docs/ChangeLog) file or [online Docs](https://gbdk.org/docs/api/docs_releases.html).
     32 
     33 
     34 ## Build status
     35 [![GBDK Build and Package](https://github.com/gbdk-2020/gbdk-2020/actions/workflows/gbdk_build_and_package.yml/badge.svg?branch=develop)](https://github.com/gbdk-2020/gbdk-2020/actions/workflows/gbdk_build_and_package.yml)
     36 
     37 ## Made with GBDK-2020
     38 See our gallery showcasing [Games and Programs made with GBDK](https://gbdk-2020.github.io/gbdk-2020-gallery/), including open source and cart release filters.
     39 
     40 [![GBDK Showcase Preview](/docs/gbdk_gallery_preview.jpg)](https://gbdk-2020.github.io/gbdk-2020-gallery/)
     41 
     42 ## Docs
     43 GBDK includes extensive [documentation](https://gbdk.org/docs/api). A good place to begin is the [Getting Started Section](https://gbdk.org/docs/api/docs_getting_started.html).
     44 
     45 Check the [Links and Third-Party Tools Section](https://gbdk.org/docs/api/docs_links_and_tools.html) for a list of recommended emulators, graphics tools, music drivers and more.
     46 
     47 For SDCC you can check its [website](http://sdcc.sourceforge.net/) and the [manual](http://sdcc.sourceforge.net/doc/sdccman.pdf)
     48 
     49 
     50 ## Usage
     51 Most users will only need to download and unzip the latest [release](https://github.com/gbdk-2020/gbdk-2020/releases)
     52 
     53 Then go to the examples folder and build them (with `compile.bat` on Windows or running `make`). They are a good starting point.
     54 
     55 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.
     56 
     57 
     58 ## Discord servers
     59 * [gbdk/zgb Discord](https://discord.gg/XCbjCvqnUY) - For help with using GBDK (and ZGB), discussion and development of gbdk-2020
     60 
     61 * [gbdev Discord](https://discordapp.com/invite/tKGMPNr) - There is a #gbdk channel and also people with a lot of Game Boy development knowledge
     62 * [SMS Power! Discord](https://discord.gg/h5xrKUK) - Additional SMS & Game Gear discussion and resources.
     63 
     64 ## Forums
     65 - [The Game Boy Development Forum](https://gbdev.gg8.se/forums/) - A good place to search for Game Boy related answers. 
     66 - [SMS Power! Forum](https://www.smspower.org/) - Additional SMS & Game Gear discussion and resources.
     67 
     68 
     69 ## Current status
     70 - Updated CRT and library that suits better for game development
     71 - SDCC Versions
     72   - A [custom build of SDCC](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases) is used with [patches](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases/tag/patches) to support Sega GG/SMS and the Nintendo NES. See the [github workflow](https://github.com/gbdk-2020/gbdk-2020-sdcc/tree/main/.github/workflows) for details of how to patch and build SDCC.
     73   - The default calling convention changed in `SDCC 4.2`. This is supported starting with `GBDK-2020 4.1.0`. Older versions of GBDK should use SDCC builds #12539 or older (see per-version GBDK notes).
     74 - The compiler driver **lcc** supports the latest sdcc toolchain.
     75 
     76 
     77 ## Origin
     78 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.
     79 
     80 The last version in the OLD repo is [2.96](https://sourceforge.net/projects/gbdk/files/gbdk/2.96/) although releases are available until 2.95-3. Version [2.96](https://sourceforge.net/projects/gbdk/files/gbdk/2.96/) is the starting point of this repo.
     81 
     82 
     83 # Build instructions
     84 Unless you are interested on recompiling the sources for some reason (like fixing some bugs) **you don't need to build GBDK**
     85 
     86 - **Windows only**: Download and install [mingw](http://mingw-w64.org/)
     87 - Clone, download this repo or just get the source from the [releases](https://github.com/gbdk-2020/gbdk-2020/releases)
     88 - Download and install the **PATCHED** [sdcc builds](https://github.com/gbdk-2020/gbdk-2020-sdcc/releases) from the separate repo for that (https://github.com/gbdk-2020/gbdk-2020-sdcc).
     89 - On Linux **don't use package managers** The latest release available won't work, you need to compile or download one of the nightlies
     90 - Create **SDCCDIR** environment variable, that points into the folder, where you installed sdcc
     91 - Open command prompt or a terminal, go to the root directory of the repo and run **make**

This webpage is intended to be an accessible preview of this repository. To get a fuller picture, clone it and use the git CLI.