Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/simonlarsen/tobutobugirl

An arcade platformer homebrew game for the Game Boy
https://github.com/simonlarsen/tobutobugirl

game-boy gameboy gbdk homebrew

Last synced: about 1 month ago
JSON representation

An arcade platformer homebrew game for the Game Boy

Host: GitHub
URL: https://github.com/simonlarsen/tobutobugirl
Owner: SimonLarsen
License: mit
Created: 2014-08-07T00:47:54.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2019-01-26T23:53:27.000Z (almost 6 years ago)
Last Synced: 2024-11-09T20:39:41.642Z (about 1 month ago)
Topics: game-boy, gameboy, gbdk, homebrew
Language: C
Homepage: http://tangramgames.dk/tobutobugirl
Size: 1.21 MB
Stars: 290
Watchers: 15
Forks: 9
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Tobu Tobu Girl ![MIT License](https://img.shields.io/badge/license-MIT%20License-blue.svg) ![CC BY 4.0](https://img.shields.io/badge/license-CC%20BY%204.0-blue.svg) ![Game Boy](https://img.shields.io/badge/platform-Game%20Boy-blue.svg)

An arcade platformer for the Game Boy.

More info at: http://tangramgames.dk/tobutobugirl.

Compilation has only been tested on Linux using GBDK 2.96a.

## Playing the game

In order to play the game you will need to either flash the game to a Game Boy flash cart or use a Game Boy emulator. The binaries are provided through [itch.io](https://tangramgames.itch.io/tobutobugirl).

## Compilation

### Install GBDK

Install GBDK version 2.96a. Make sure the `lcc` compiler is in your PATH and the `GBDKDIR` environment variable is set up correctly.

### Install imgtogb

Download and compile [imgtogb](https://github.com/SimonLarsen/pyimgtogb) and add it to your PATH. Alternatively you can change the `IMGTOGB` variable in the [Makefile](Makefile) to point to the imgtogb.py file.

### Compiling the rom

Clone the Tobu Tobu Girl repository using the `--recursive` flag to clone the [mmlgb](https://github.com/SimonLarsen/mmlgb) submodule as well.

```
git clone --recursive https://github.com/SimonLarsen/tobutobugirl
cd tobutobugirl
```

Download the `MMLGB.jar` file and place it in the root folder.

```
wget https://github.com/SimonLarsen/mmlgb/releases/download/v0.1/MMLGB.jar
```

Then compile rom file with `make`.

```
make
```

If all went well, a rom file `tobu.gb` will be created in the project root.

## License

The source code for Tobu Tobu Girl is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

All assets (images, text, sound and music) are licensed under the [Creative Commons Attribution 4.0 International License](http://creativecommons.org/licenses/by/4.0/).