02_links_and_tools.md (5484B)
1@page docs_links_and_tools Links and Third-Party Tools 2 3 4This is a brief list of useful tools and information. It is not meant to be complete or exhaustive, for a larger list see the @ref awesome_gb "Awesome Game Boy Development" list. 5 6@anchor links_sdcc_docs 7# SDCC Compiler Suite User Manual 8 - 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. 9 http://sdcc.sourceforge.net/doc/sdccman.pdf 10 http://sdcc.sourceforge.net 11 12 13@anchor links_help_and_community 14# Getting Help 15 - GBDK Discord community: 16 https://github.com/gbdk-2020/gbdk-2020/#discord-servers 17 18 - Game Boy discussion forum: 19 https://gbdev.gg8.se/forums/ 20 21 22@anchor links_gameboy_docs 23# Game Boy Documentation 24 - @anchor Pandocs 25 __Pandocs__ 26 Extensive and up-to-date technical documentation about the Game Boy and related hardware. 27 https://gbdev.io/pandocs/ 28 29 - @anchor awesome_gb 30 __Awesome Game Boy Development list__ 31 A list of Game Boy/Color development resources, tools, docs, related projects and homebrew. 32 https://gbdev.io/list.html 33 34 35@anchor links_sms_gg_docs 36# Sega Master System / Game Gear Documentation 37 - @anchor smspower 38 __SMS Power!__ 39 Community site with technical documentation, reviews and other content related to the Sega 8-bit systems. 40 https://www.smspower.org/ 41 42 43@anchor links_gbdk_tutorials 44# Tutorials 45 - @anchor tutorials_larolds 46 __Larold's Jubilant Junkyard Tutorials__ 47 Several walk throughs about the fundamentals of developing for the Game Boy with GBDK-2020. There are simple examples with source code. 48 https://laroldsjubilantjunkyard.com/tutorials/ 49 50 - @anchor tutorials_gamingmonsters 51 __Gaming Monsters Tutorials__ 52 Several video tutorials and code for making games with GBDK/GBDK-2020. 53 https://www.youtube.com/playlist?list=PLeEj4c2zF7PaFv5MPYhNAkBGrkx4iPGJo 54 https://github.com/gingemonster/GamingMonstersGameBoySampleCode 55 56 - @anchor tutorials_typorter 57 __Pocket Leage Tutorial__ 58 https://blog.ty-porter.dev/development/2021/04/04/writing-a-gameboy-game-in-2021-pt-0.html 59 60 61@anchor link_examples 62# Example code 63 - @anchor examples_gbdk_playground 64 __Simplified GBDK examples__ 65 https://github.com/mrombout/gbdk_playground/commits/master 66 67 68@anchor links_graphic 69# Graphics Tools 70 - @anchor gbtd_gbmb 71 @anchor gbmb 72 @anchor gbtd 73 @anchor toxa_gbtd_gbmb 74 __Game Boy Tile Designer and Map Builder (GBTD / GBMB)__ 75 Sprite / Tile editor and Map Builder that can export to C that works with GBDK. 76 This is an updated version with const export fixed and other improvements. 77 https://github.com/gbdk-2020/GBTD_GBMB 78 79 - A GIMP plugin to read/write GBR/GBM files and do map conversion: 80 https://github.com/bbbbbr/gimp-tilemap-gb 81 - Command line version of the above tool that doesn't require GIMP (png2gbtiles): 82 https://github.com/bbbbbr/gimp-tilemap-gb/tree/master/console 83 84 - @anchor Tilemap_Studio 85 __Tilemap Studio__ 86 A tilemap editor for Game Boy, GBC, GBA, or SNES projects. 87 https://github.com/Rangi42/tilemap-studio/ 88 89 90@anchor tools_music 91# Music drivers and tools 92 - @anchor gbt-player 93 __GBT Player__ 94 A .mod converter and music driver that works with GBDK and RGBDS. 95 https://github.com/AntonioND/gbt-player 96 Docs from GBStudio that should mostly apply: https://www.gbstudio.dev/docs/music/ 97 98 99 - @anchor hUGEdriver 100 __hUGEtracker__ and __hUGEdriver__ 101 A tracker and music driver that work with GBDK and RGBDS. 102 It is smaller, more efficient and more versatile than gbt_player. 103 https://github.com/untoxa/hUGEBuild 104 https://github.com/SuperDisk/hUGEDriver 105 https://github.com/SuperDisk/hUGETracker 106 107 108@anchor tools_emulators 109# Emulators 110 - @anchor bgb 111 __BGB__ 112 Accurate emulator, has useful debugging tools. 113 http://bgb.bircd.org/ 114 115 - @anchor emulicious 116 __Emulicious__ 117 An accurate emulator with extensive tools including source level debugging. 118 https://emulicious.net/ 119 120 121@anchor tools_debug 122# Debugging tools 123 - @anchor Emulicious_debug 124 __Emulicious debug adapter__ 125 Provides source-level debugging in VS Code that works with GBDK2020. 126 https://marketplace.visualstudio.com/items?itemName=emulicious.emulicious-debugger 127 128 - @anchor romusage 129 __romusage__ 130 Calculate used and free space in banks (ROM/RAM) and warn about errors such as bank overflows. 131 https://github.com/bbbbbr/romusage 132 133 - @anchor bgb_symbol_conversion 134 __noi file to sym conversion for bgb__ 135 Debug information in .noi files can be converted to a symbol format that @ref bgb "BGB" recognizes using: 136 - @ref lcc : `-Wm-yS` (with `--debug`, or `-Wl-j` to create the .noi) 137 - directly with @ref makebin : `-yS` (with `-j` passed to the linker) 138 139 - @anchor src2sym 140 __src2sym.pl__ 141 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. 142 https://gbdev.gg8.se/forums/viewtopic.php?id=710 143 144 145@anchor tools_build_ci_cd 146# Continuous Integration and Deployment 147 - @anchor GBDK_GitHub_Action_Builder 148 __GBDK GitHub Action Builder__ 149 A Github Action which provides basic CI/CD for building projects based on GBDK (not for building GBDK itself). 150 https://github.com/wujood/gbdk-2020-github-builder 151