Repository files navigation

This repository contains example programs for the Nintendo GameBoy video game console. The examples are related to articles on my blog (in French).

Screenshot	Name	Description
	01 - Hello World	Simple program that prints "Hello World" on the screen
	02 - Gamepad	Simple program shows how to use gamepad in a GameBoy program
	03 - Tic Tac Toe	A complete example project to show how to make a simple game for the GameBoy
	04 - Graphics 1	Simple example to show how to draw tiles on the GameBoy
	05 - Graphics 2	Convert an image using img2gb and display it
	06 - Graphics 3 - background	Background layer scrolling example
	07 - Graphics 4 - sprites	A complete sprite example with an animated player
	08 - Graphics 5 - window	Window layer example
	09 - Graphics 6 - palettes	Playing with color palettes
	10 - Breakout	Simple breakout game
	11 - Custom Text	Handle and display text

First you need to install some dependencies: SDCC (with its libraries), GNU Make, git. This can be installed with the following command on Debian / Ubuntu:

sudo apt install build-essential sdcc sdcc-libraries git

Then clone this repository and get submodules:

git clone https://github.com/flozz/gameboy-examples.gitcd gameboy-examplesgit submodule initgit submodule update

Then you have to build the gbdk-n library (this needs to be done only once):

cd gbdk-nmakecd ..

Finally, you can build examples with themake command from the directory of the example. For example, if you want to build the "Hello World" example, you will have to run the following commands:

cd 01-hello-world/make

You can now run the generated.gb file with your favorite emulator.

If you want to cleanup the folder from all generated files (*.rel,*.lst,*.gb,...), you can use the following command:

make clean

To build the examples on Windows, you first have to download and installthe latest SDCC version.

Then clone this repository and get submodules:

git clone https://github.com/flozz/gameboy-examples.gitcd gameboy-examplesgit submodule initgit submodule update

Then you have to build the gbdk-n library (this needs to be done only once).

If you are using CMD.exe:

cd gbdk-nmakecd ..

If you are using Git Bash:

cd gbdk-n./Make.batcd ..

Finally go to an example folder:

cd 01-hello-world

And build it using theMake.bat file.

If you are using CMD.exe:

make

If you are using Git Bash:

./Make.bat

You can now run the generated.gb file with your favorite emulator.

If you want to cleanup the folder from all generated files (*.rel,*.lst,*.gb,...), you can use the following command:

If you are using CMD.exe:

make clean

If you are using Git Bash:

./Make.bat clean

Some of the examples have assets (tilesets, tilemaps, sprites,...). If you changes the images, you will have to rebuild assets.

You will first need toinstall img2gb. This can be done with the following command:

sudo pip install img2gb

Then, just run the following command (from the example directory):

make assets

You first have to get the Windows version of img2gb :

• Download de latest img2gb binary for Windows,
• then rename itimg2gb.exe,
• and put it in the project folder (in the same folder than theMake.bat file).

Finally, open a terminal in the project's folder and use the following command to rebuild the assets :

make assets

The previous command will work if you are using CMD.exe, but if you are using Git Bash, type this one instead :

./Make.bat assets

The examples in this repository are licensed under WTFPL unless otherwise stated:

        DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE                    Version 2, December 2004 Copyright (C) 2004 Sam Hocevar <sam@hocevar.net> Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed.            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION  0. You just DO WHAT THE FUCK YOU WANT TO.