whatisgithub

What is supaplex-gba?

vegard/supaplex-gba — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2012-10-17

C++Audience · vibe coderComplexity · 3/5DormantSetup · moderate

In one sentence

A C++ port of the classic 1991 puzzle game Supaplex to the Game Boy Advance, letting you push rocks, dodge enemies, and collect gems on real GBA hardware.

Mindmap

mindmap
  root((supaplex-gba))
    What it does
      Puzzle game port
      GBA hardware
      Classic gameplay
    Tech stack
      C++
      GBA hardware
    Use cases
      Play Supaplex on GBA
      Learn retro game porting
      Explore classic puzzles
    Audience
      Retro gamers
      GBA developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play the original Supaplex puzzle game on a real GBA cartridge or emulator.

USE CASE 2

Study the C++ source code to learn how classic puzzle-game logic works.

USE CASE 3

Learn techniques for porting older games to constrained handheld hardware.

USE CASE 4

Build and flash a custom GBA ROM for retro gaming enthusiasts.

What is it built with?

C++Game Boy Advance

How does it compare?

vegard/supaplex-gbaachanana/mavsdkalange/llama.cpp
Stars0
LanguageC++C++C++
Last pushed2012-10-172024-05-20
MaintenanceDormantDormant
Setup difficultymoderatemoderatemoderate
Complexity3/54/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a GBA development toolchain (devkitARM) or an emulator to run the compiled ROM.

So what is it?

This is a port of the classic puzzle game Supaplex to the Game Boy Advance (GBA), a handheld gaming console from the early 2000s. It lets you play Supaplex, a beloved 1991 puzzle game where you navigate through underground caves, pushing rocks and collecting gems while avoiding enemies, directly on your GBA cartridge. Supaplex is a puzzle-platformer where timing and spatial reasoning matter. You control a character moving through grid-based levels, pushing heavy objects into specific positions to clear paths, collect items, or trigger mechanisms. The challenge comes from limited moves, falling rocks, and creatures that chase you. By bringing this game to the GBA, you can carry it around and play on the go, just like you would with any GBA cartridge. The project is written in C++, which is compiled down to run natively on the GBA's hardware. This means it takes the core game logic and graphics from the original and optimizes them to fit the GBA's more modest processing power and screen size compared to modern systems. The README doesn't go into detail about specific features or which levels are included, so if you're interested in diving deeper, you'd want to check the full source code or documentation in the repository itself. People who would find this useful include retro gaming enthusiasts who own a GBA or GBA emulator and want to experience Supaplex on that platform, and developers interested in learning how to port older games to classic handheld hardware. If you grew up with Supaplex on home computers or want to explore classic puzzle games in their native handheld form, this lets you do that.

Copy-paste prompts

Prompt 1
Show me how to build this Supaplex GBA port from source and run it on a GBA emulator.
Prompt 2
Walk me through the C++ code that handles pushing rocks and collecting gems in this Supaplex port.
Prompt 3
Explain how this project adapts Supaplex's original game logic to fit the GBA's limited hardware.
Prompt 4
Help me flash the compiled ROM from this repo onto a real GBA cartridge.

Frequently asked questions

What is supaplex-gba?

A C++ port of the classic 1991 puzzle game Supaplex to the Game Boy Advance, letting you push rocks, dodge enemies, and collect gems on real GBA hardware.

What language is supaplex-gba written in?

Mainly C++. The stack also includes C++, Game Boy Advance.

Is supaplex-gba actively maintained?

Dormant — no commits in 2+ years (last push 2012-10-17).

How hard is supaplex-gba to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is supaplex-gba for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.