GBDK 2020 Docs API Documentation for GBDK 2020

Links and Third-Party Tools

This is a brief list of useful tools and information. It is not meant to be complete or exhaustive, for a larger list see awesome_gb

# SDCC Compiler Suite User Manual

- GBDK-2020 uses the SDCC compiler and related tools. The SDCC manual goes into much more detail about available features and how to use them.
  http://sdcc.sourceforge.net/doc/sdccman.pdf
  http://sdcc.sourceforge.net

# Game Boy Documentation

- Pandocs
  Extensive and up-to-date technical documentation about the Game Boy and related hardware.
  https://gbdev.io/pandocs/
- Awesome Game Boy List
  A list of Game Boy/Color development resources, tools, docs, related projects and homebrew.
  https://gbdev.io/list.html

# Tutorials

- Gaming Monsters Tutorials
  Several video tutorials and code for making games with GBDK/GBDK-2020.
  https://www.youtube.com/playlist?list=PLeEj4c2zF7PaFv5MPYhNAkBGrkx4iPGJo
  https://github.com/gingemonster/GamingMonstersGameBoySampleCode

# Graphics Tools

- Game Boy Tile Designer and Map Builder (GBTD / GBMB)
  Sprite / Tile editor and Map Builder that can export to C that works with GBDK.
  https://github.com/untoxa/GBTD_GBMB (updated version with improvements and fixes)
  http://www.devrs.com/gb/hmgd/intro.html (original tools)
  https://github.com/bbbbbr/gimp-tilemap-gb (GIMP plugin to read/write GBR/GBM files)
- Tilemap Studio
  A tilemap editor for Game Boy, GBC, GBA, or SNES projects.
  https://github.com/Rangi42/tilemap-studio/

# Music drivers and tools

- GBT Player
  A .mod converter and music driver that works with GBDK and RGBDS.
  https://github.com/AntonioND/gbt-player
  Docs from GBStudio that should mostly apply: https://www.gbstudio.dev/docs/music/
- hUGEdriver
  A tracker and music driver that works with GBDK and RGBDS. It is smaller, more efficient and more versatile than gbt_player.
  https://github.com/untoxa/hUGEBuild
  https://github.com/SuperDisk/hUGEDriver
  https://github.com/SuperDisk/hUGETracker

# Emulators

- BGB
  Accurate emulator, has useful debugging tools.
  http://bgb.bircd.org/
- Emulicious
  An accurate emulator with extensive tools including source level debugging.
  https://emulicious.net/

# Debugging tools

- Emulicious debug adapter
  Provides source-level debugging in VS Code that works with GBDK2020.
  https://marketplace.visualstudio.com/items?itemName=emulicious.emulicious-debugger
- romusage
  Calculate used and free space in banks (ROM/RAM) and warn about errors such as bank overflows.
  https://github.com/bbbbbr/romusage
- noi2sym.py
  Convert .noi files into a symbol format compatible with BGB. Allows BGB to recognize variables and functions based on address.
  https://github.com/untoxa/hUGEBuild/blob/master/tools/noi2sym.py
- src2sym.pl
  Add line-by-line C source code to the main symbol file in a BGB compatible format. This allows for C source-like debugging in BGB in a limited way. https://gbdev.gg8.se/forums/viewtopic.php?id=710