https://github.com/issotm/gb-starter-kit

A customizable and ready-to-compile bundle for Game Boy RGBDS projects. Contains your bread and butter, guaranteed 100% kitchen sink-free.
https://github.com/issotm/gb-starter-kit

asm assembly build-system gameboy gameboy-color gbdev rgbds

Last synced: 2 months ago
JSON representation

A customizable and ready-to-compile bundle for Game Boy RGBDS projects. Contains your bread and butter, guaranteed 100% kitchen sink-free.

• Host: GitHub
• URL: https://github.com/issotm/gb-starter-kit
• Owner: ISSOtm
• License: zlib
• Created: 2020-04-25T18:47:09.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2025-04-06T11:21:01.000Z (3 months ago)
• Last Synced: 2025-04-09T23:16:33.474Z (2 months ago)
• Topics: asm, assembly, build-system, gameboy, gameboy-color, gbdev, rgbds
• Language: Assembly
• Homepage: http://eldred.fr/gb-starter-kit/build-system.pdf
• Size: 104 KB
• Stars: 59
• Watchers: 3
• Forks: 10
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gb-starter-kit

A customizable and ready-to-compile setup for Game Boy projects using RGBDS.

*Contains your bread and butter, yet guaranteed 100% kitchen-sink-free!*

> [!WARNING]

> Windows users: please use [WSL](https://learn.microsoft.com/en-us/windows/wsl/install)! Due to a bug in Make, this project will **not** work outside of WSL!

**[The wiki](https://github.com/ISSOtm/gb-starter-kit/wiki) has information on how to use this project.**

## See also

If you want something more barebones, check out [gb-boilerplate](https://github.com/ISSOtm/gb-boilerplate).

Perhaps [a gbdev style guide](https://gbdev.io/guides/asmstyle) may be of interest to you?

I recommend the [Emulicious](https://emulicious.org) emulator for developing ROMs, as it has the best debugging features out there.

[SameBoy](https://github.com/LIJI32/SameBoy) is slightly more accurate, but has a more lackluster interface outside of macOS.

### Libraries

- [Variable-width font engine](https://github.com/ISSOtm/gb-vwf#readme)

- [Structs in RGBDS](https://github.com/ISSOtm/rgbds-structs#readme)

- [Sound drivers](https://github.com/ISSOtm/fortISSimO/wiki/Drivers-comparison)