GBTiles

wercker status Code Climate Test Coverage

Converts .GBR files created with Harry Mulder's Tile Designer (GBTD) and .GBM files created with Harry Mulder's Map Builder (GBMB) to different formats for use with the Game Boy and GBDK.

N.B.: Not all of the functionality provided by Harry Mulder's GBR and GBM file format specification have been implemented; however there is enough to generate the basics for tiles and maps.

Installation

gem install gbtiles

Usage

Help

To view help information for the GBR or GBM commands, simply type one of the following:

gbr --help
gbm --help

GBR (GBTD files)

Converts a Tile Designer file *.gbr to an ASM file *.s and generates a C file *.h for convenience.

gbr convert --output "sample.s" sample.gbr

Omitting the input file .gbm file will default to STDIN. Omitting the output file .s will default to STDOUT.

GBM (GBMB files)

Converts a Map Builder file *.gbm to an ASM file *.s and generates a C file *.h for convenience.

gbm convert --output "sample.s" sample.gbm

You can also specify the target layer of a map specifying a layer flag. Acceptable values: bkg for the background, win for the window overlay or sprite for sprites. Default value: bkg.

gbm convert --output "sample.s" --layer=bkg sample.gbm

Omitting the input file .gbm file will default to STDIN. Omitting the output file .s will default to STDOUT.

Contributors

If you fork this project and create a pull request add your GitHub username, your full name and website to the end of list above.