Recently, in order to realize some of my childhood dreams, I have been learning about Game Boy Advance (GBA) development using Jasper Vijn’s awesome Tonc guide. He is great at explaining the art of GBA development, so please read his blog if you are interested as well1! One of the first things you will learn is that the GBA does almost2 everything with hardware-rendered tile maps.
Configuring a tile map takes a few steps, which includes formatting the map into binary data the GBA’s internal hardware can understand. This is a shame, as many digital artists and game designers have no (desire to acquire) skills in the black art of manually typing hexadecimal values into a text editor. And nor should they: most of these artist are experienced with Tiled, a neat and well-grown tile map editor.
In order to allow these creative individuals to work with the GBA, I
decided to create a tiny tool that converts Tiled
.tmx map files into one
of the two following formats:
This tool is open-source, and can be found on Github.
The repository’s documentation should explain its usage well enough (and
Tiled2GBA --help does so as well), but in general
you can simply call the binary
Tiled2GBA with a map file and output location
As an example, have a look at the tiled map below:
Tiled2GBA map.tmx map.bin --binary and appending it to the end of
mapViewer.gba will allow you to view it on your GBA:
Cool right? This is the power of a data-driven architecture, where your game can both run on a Windows-10 x64 machine, as well as an ARM-based console from 2001. You cannot convince me that this isn’t extremely neat.
Not all kinds of map properties are compatible with the GBA,
and thus cannot be optimally converted. Tiled2GBA will either
WARN the user or
ERROR message. These limitations include:
Again, you should not be scared of any odd behavior when breaking these limitations, the tool will clearly warn you if you break them.
Do not feel like compiling the sources yourselves? You can download the binary for both Windows 10 and Debian Linux here.
Although the platform might be old and dusty, the limitations you will face whilst programming on this console are a great way to improve your general programming skills and hone your grasp of memory management. I can babble a lot about memory management, and maybe I will… someday. ↩