Bananas

A 2-player artillery game for the original Game Boy (DMG), plus a Python wrapper PyBananas for AI/ML training. Inspired by the classic Gorillas (1991): two kongs, destructible randomized terrain, ballistic bananas.

  

TL;DR

Download latest release ROM, run with SameBoy or mGBA.

Prerequisites

• Docker (containerized build environment)
• SameBoy (GameBoy emulator)
• Pixi (optional, for PyBananas development)

Build environment

./scripts/init.sh             # one-time Docker build env setup
./scripts/build.sh            # release build → build/bananas.gb
./scripts/build.sh DEBUG=1    # debug build with .map + .sym/.noi symbols
./scripts/play.sh             # launch SameBoy with build/bananas.gb
./scripts/clean.sh            # wipe build/ and PyBananas artifacts

All scripts are also available as VS Code tasks via Terminal → Run Task.

How to play

Controls — D-pad: aim · A: fire · B: peek at opponent

Project Layout

src/              Source code — gameplay, physics, rendering, input, sfx
assets/           PNG images (auto-converted to GB tile data by png2asset)
build/
  bananas.gb      ROM output
  generated/      auto-generated source code
PyBananas/        PyBoy-based Python wrapper for AI/ML training
  dist/pybananas-(...).whl
scripts/          build scripts
Makefile          build rules + asset pipeline
Dockerfile        GBDK build environment

PyBananas

See PyBananas