A collection of Gameboy projects I made while learning GBz80 Assembly.
The repository comes with scripts for building and running the ROMs. RGBDS will be required in the build process. Make sure it is found in your %PATH%.
I used the BGB64 emulator. Feel free to edit the batch files in order to use your favorite Gameboy emulator.
Building example:
C:\Gameboy-ASM-Examples>build 1.vblank
Building 1.vblank
:: rgbasm -o main.o main.asm
Linking...
:: rgblink -o 1.vblank.gb main.o
Fixing ROM...
:: rgbfix -v -p 0 1.vblank.gb
Cleaning...
Launching... # test the ROM on the Gameboy emulator
Done.
If there's no need to build the ROM, just run it:
C:\Gameboy-ASM-Examples>run 1.vblank
Launching...
Done.
There are precompiled ROMs in the bin folder.
| Id | Name | Description |
|---|---|---|
| 0 | hello-world | First ROM |
| 1 | vblank | Learn using vBlank |
| 2 | tiles | Learn using tilesets/tilemaps |
| 3 | vblank-handler | Faster vBlank using halt |
- Tileset Generator - html tool to create Gameboy Tiles
- Tilemap Creator - html tool to create Gameboy Tilemaps