Initial commit

Author: mdeclerk

.github/workflows/CI.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build Docker image (bananas-buildenv)
+        run: bash scripts/init.sh
+
+      - name: Compile ROM
+        run: bash scripts/build.sh
+
+      - name: Verify ROM
+        run: |
+          test -s build/bananas.gb
+          # Nintendo logo magic byte at 0x0104 — proves cart header is well-formed
+          xxd -s 0x104 -l 1 build/bananas.gb | grep -q "ce"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: bananas-gb
+          path: build/bananas.gb

.gitignore

@@ -0,0 +1,21 @@
+# Build output
+build/
+
+# GBDK intermediate files
+*.o
+*.lst
+*.sym
+*.map
+*.cdb
+*.ihx
+*.noi
+
+# macOS
+.DS_Store
+
+# editors
+.vscode/
+.idea/
+*.swp
+
+.venv/

.vscode/tasks.json

@@ -0,0 +1,45 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Bananas: Init Docker Container",
+      "type": "shell",
+      "command": "${workspaceFolder}/scripts/init.sh",
+      "group": "build",
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": []
+    },
+    {
+      "label": "Bananas: Build",
+      "type": "shell",
+      "command": "${workspaceFolder}/scripts/build.sh",
+      "group": { "kind": "build", "isDefault": true },
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": []
+    },
+    {
+      "label": "Bananas: Clean",
+      "type": "shell",
+      "command": "${workspaceFolder}/scripts/build.sh clean",
+      "group": "build",
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": []
+    },
+    {
+      "label": "Bananas: Play",
+      "type": "shell",
+      "command": "${workspaceFolder}/scripts/play.sh",
+      "group": "test",
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": []
+    },
+    {
+      "label": "Bananas: Build & Play",
+      "dependsOrder": "sequence",
+      "dependsOn": ["Bananas: Build", "Bananas: Play"],
+      "group": "test",
+      "presentation": { "reveal": "always", "panel": "shared" },
+      "problemMatcher": []
+    }
+  ]
+}

Dockerfile

@@ -0,0 +1,26 @@
+# syntax=docker/dockerfile:1
+
+FROM debian:bookworm-slim
+
+ARG GBDK_VERSION=4.5.0
+ARG TARGETARCH
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+      make \
+      curl \
+      ca-certificates \
+      tar \
+      xz-utils \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN case "${TARGETARCH}" in \
+      arm64) TARBALL="gbdk-linux-arm64.tar.gz" ;; \
+      *)     TARBALL="gbdk-linux64.tar.gz" ;; \
+    esac && \
+    curl -fsSL "https://github.com/gbdk-2020/gbdk-2020/releases/download/${GBDK_VERSION}/${TARBALL}" | tar -xz -C /opt
+
+ENV PATH="/opt/gbdk/bin:${PATH}"
+ENV GBDK_HOME="/opt/gbdk"
+
+WORKDIR /bananas

Makefile

@@ -0,0 +1,39 @@
+GBDK_HOME ?= /opt/gbdk
+
+BUILD_DIR := build
+ROM := $(BUILD_DIR)/bananas.gb
+GEN_DIR := $(BUILD_DIR)/generated
+SRC_DIR := src
+ASSET_DIR := assets
+
+CC := $(GBDK_HOME)/bin/lcc
+PNG2ASSET := $(GBDK_HOME)/bin/png2asset
+
+ASSET_PNGS := $(wildcard $(ASSET_DIR)/*.png)
+ASSET_SRCS := $(patsubst $(ASSET_DIR)/%.png,$(GEN_DIR)/%.c,$(ASSET_PNGS))
+ASSET_HDRS := $(ASSET_SRCS:.c=.h)
+SRCS := $(shell find $(SRC_DIR) -name '*.c') $(ASSET_SRCS)
+HDRS := $(shell find $(SRC_DIR) -name '*.h') $(ASSET_HDRS)
+
+CPPFLAGS := -I$(BUILD_DIR)
+
+PNG2ASSET_FLAGS := -keep_duplicate_tiles -no_palettes -map -bpp 2 -tiles_only -pack_mode gb -noflip -keep_palette_order
+
+all: $(ROM)
+
+$(BUILD_DIR) $(GEN_DIR):
+	mkdir -p $@
+
+$(GEN_DIR)/%.c: $(ASSET_DIR)/%.png Makefile | $(GEN_DIR)
+	$(PNG2ASSET) $< $(PNG2ASSET_FLAGS) -c $@
+
+# png2asset writes the matching header as a side effect of generating the C file.
+$(GEN_DIR)/%.h: $(GEN_DIR)/%.c ;
+
+$(ROM): $(SRCS) $(HDRS) | $(BUILD_DIR)
+	$(CC) $(CPPFLAGS) -o $@ $(SRCS)
+
+clean:
+	rm -rf $(BUILD_DIR)
+
+.PHONY: all clean

README.md

@@ -0,0 +1,50 @@
+# Bananas
+
+[![CI](https://github.com/mdeclerk/Bananas/actions/workflows/CI.yml/badge.svg)](https://github.com/mdeclerk/Bananas/actions/workflows/CI.yml)
+
+A 2-player artillery game for the original Game Boy (DMG), inspired by the classic [Gorillas (1991)](https://en.wikipedia.org/wiki/Gorillas_(video_game)). Two kongs, randomized & destructible terrain, ballistic bananas.
+
+<p align="center">
+  <img src="docs/image1.png" alt="Title screen" width="360">
+  &nbsp;&nbsp;
+  <img src="docs/image2.png" alt="Gameplay" width="360">
+</p>
+
+## Getting Started
+
+```sh
+./scripts/init.sh     # one-time Docker build env setup
+./scripts/build.sh    # compile → build/bananas.gb
+./scripts/play.sh     # launch SameBoy (or mGBA)
+```
+
+All scripts are also available as VS Code tasks via **Terminal → Run Task** (Init, Build, Clean, Play, Build & Play).
+
+## How to play
+
+**Controls** — D-pad: aim · A: fire · B: peek at opponent
+
+<p align="center">
+  <img src="docs/gameplay.gif" alt="Gameplay demo" width="336">
+</p>
+
+## Prerequisites
+
+- Docker (containerized build environment)
+- [SameBoy](https://sameboy.github.io/) (GameBoy emulator)
+- macOS, Linux, or WSL. Apple Silicon supported (Dockerfile auto-selects arm64 GBDK).
+
+Inside the container: GBDK-2020 4.5.0, `lcc`/SDCC, `png2asset`, `make`.
+
+## Project Structure
+
+```
+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
+scripts/          build scripts
+Makefile          build rules + asset pipeline
+Dockerfile        GBDK build environment
+```