← Back to blog

Fitting Jungle Jumper onto a Game Boy Advance

Porting a Phaser and TypeScript browser platformer to a 240 by 160 screen, a 664 kB cartridge and a handful of buttons, without losing what made it fun.

Where it started

Jungle Jumper began life as a browser game: a jungle-themed vertical platformer built with Phaser 3, TypeScript and Vite. You hop up a giant tree, branch by branch, and try to climb as high as you can before the screen catches you.

It worked well on the web, which is exactly why porting it was interesting. The browser hides almost every constraint. A Game Boy Advance hides none of them.

Setting the rule for the port

Before touching anything I set one rule: it should feel like the same game. That meant keeping:

  • the jump physics and jump heights
  • the gaps between branches
  • the difficulty curve as you climb

The only place I allowed the numbers to move was where the smaller screen made them unfair. The GBA's 240 by 160 display shows far less of the tree at once, so a few values are eased slightly to give players the same reaction time they had on the web.

The tools

The port is built with Artur Duleba's GBA Maker and the GBA Coder kit, which handle the low-level work of getting graphics, input and sound onto real hardware. That let me spend my time on the game rather than on the toolchain.

The finished ROM is 664 kB.

Designing for four buttons

A keyboard and a touch screen give you plenty of room for controls. A GBA gives you a D-pad, A, B, L, R and Start, so every action needed a clear home:

  • D-pad left and right to move, wrapping around the screen edges.
  • A to jump.
  • Start to pause.
  • An optional setting to jump with Up, for players who prefer it.
  • L and R to flip between the records and achievements pages.

Keeping the in-game controls to essentially three buttons was a deliberate choice. A platformer lives or dies on how quickly you can react, and every extra input is something to think about mid-jump.

What made the cut

Constraints force decisions, and the port ended up with a clear feature set:

  • Five climbers – Miko, Pico, Hoppy, Tuki and Zippy – each with their own ability. Pico, for example, can jump again in mid-air.
  • Four branch types: steady, moving, crumbling and spring.
  • Four hazards: snakes, falling coconuts, thorns and bats.
  • Five altitude bands that change the scenery as you climb, from the Lower Jungle up to the Night Storm.

Saving progress like a real cartridge

The web version could lean on browser storage. On the GBA, progress lives in 32 KB of battery-backed SRAM, just like a commercial cartridge. That holds:

  • best height overall and per climber
  • total runs and distance climbed
  • shields found and springs used
  • twelve achievements
  • a mid-climb Save & Quit, with Continue on the title screen

The ROM includes the standard SRAM tag so emulators such as mGBA detect the save type automatically. If you play on a flash cart, you may need to set the save type to SRAM yourself.

Accessibility still matters on old hardware

It would have been easy to treat accessibility as a web concern. Instead the options menu includes sound effects and music toggles and a reduced motion setting, alongside the alternative jump control. Small options like these cost very little and make the game comfortable for more people.

What I took away

The browser version taught me how to make the game. The GBA version taught me what the game actually is. When you cannot add a menu, a tooltip or another megabyte of assets, you find out quickly which parts matter.

Play it

Jungle Jumper GBA is available as a name-your-own-price download on itch.io. Play it in mGBA or on a GBA, GBA SP, DS or DS Lite with a flash cart.