Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lancekindle/DMGreport

DMG and CGB (Color Game Boy) tutorials for coding assembly games with RGBDS
https://github.com/lancekindle/DMGreport

Last synced: 2 months ago
JSON representation

DMG and CGB (Color Game Boy) tutorials for coding assembly games with RGBDS

Host: GitHub
URL: https://github.com/lancekindle/DMGreport
Owner: lancekindle
Created: 2017-12-21T21:48:50.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2018-01-22T22:10:34.000Z (over 6 years ago)
Last Synced: 2024-01-24T13:34:26.416Z (5 months ago)
Language: Assembly
Size: 168 KB
Stars: 57
Watchers: 5
Forks: 10
Open Issues: 1
Metadata Files:
- Readme: README.MD

Lists

awesome-gbdev - DMGreport - Game programming tutorials in assembly. (Programming / ASM)
awesome-gb-dev-zh - DMGreport

README

        # DMG-report

DMG and CGB (Game Boy and Color GameBoy) game programming tutorials in assembly compiled with [RGBDS](https://github.com/rednex/rgbds)

| ![minimal_background_scroll](images/minimal_background_scroll.asmclip.gif) | ![better_sprite_moves](images/better_sprite_moves.asmclip.gif) | ![palette_change_animation](images/palette_change_animation.asmclip.gif) | ![hello_world_background](images/hello_world_background.asmclip.gif) |

| -- | -- | -- | -- |

| ![color_palette_exploration](images/color_palette_exploration.asmclip.gif) | ![background_color_gradient](images/background_color_gradient.asmclip.gif) | ![custom_graphics](images/custom_graphics.asmclip.gif) | ![background_2x_height](images/background_2x_height.asmclip.gif) |

The goal of this repository is to contain minimal code designed to teach the basics of creating assembly games for the GameBoy and GameBoy Color. This repository assumes two things: You'll be compiling with [RGBDS](https://github.com/rednex/rgbds) and that you'll be testing with [BGB](http://bgb.bircd.org/).

We start with teaching how to scroll the background, then move to sprite movement, capturing input from the gameboy's joypad, and then setting colors on the background and sprites.

#### Compiling

You can compile each example by running the running the following script:

```

rgbasm -o  

rgblink -o a.gb 

rgbfix -v -p0 a.gb

rm 

```

so building the file `01_minimal_template.asm` as an example:

```

rgbasm -o 01_minimal_template.obj 01_minimal_template.asm

rgblink -o a.gb 01_minimal_template.obj

rgbfix -v -p0 a.gb

rm 01_minimal_template.obj

```

Now you can run the built game with bgb: Start up bgb and drag and drop / open the file. Or you can launch it through the command-line:

linux:

`wine ~/path/to/bgb/bgb.exe a.gb`

windows:

`path/to/bgb/bgb.exe a.gb`