Issung/Gematrix

Gem Matching game for the Game Boy Advance, entry for the GBAJam2024

GBA Jam 2024

My first and hopefully not last Game Boy Advance game! Written in C++ with Butano for GBA Jam 2024.

Credits

• Butano by GValiente.
• SFX made with Bfxr.
• Font by 2Pblog1.
• Menu music: pms_are1.it by Powerack
• Game music #1: 4_RNDD!.xm by Drozerix.
• Game music #2: biotech.rth by Kokesz.
• Game music #3: Cirno.it by Maris.
• Game music #4: Fckdarules.xm by JAM.
• Game music #5: L3V3L_33 by Drozerix.

Development

Requirements

• This project has the same requirements as Butano, follow getting started instructions here.
  • GBA Emulator (using mGBA for this project).
  • devkitARM.
  • Python (use pyenv).
  • Butano (imported as a submodule).

Extra Tools Used

• Usenti for sprite editing in format supported by the GBA.
• VS Code used as IDE, this repo contains configuration to use it.

Guides Used

• Butano Getting Started.
• GDB Debugging with mGBA.
• Embedding emulator on itch.io.
• Help from the lovely folks in the gbadev Discord.

Build / Debug

1. Clone the repo and cd into it.
2. git submodule update --init to pull Butano submodule.
3. cd into src this is where the actual GBA project is stored.
4. make -j$(nproc) to build using the makefile.
5. Open the output .gba file with your emulator to play.

Debugging:

• The .elf file contains all the debug symbols, run this to debug.
  • This is what is launched by VSCode debugging, specified in launch.json.
• If you want a better debugging experience you can play in the Makefile.
  • Set USERFLAGS to -Og to disable most optimisations.