Beck

Android game · 2026

Ki Runner

An Android game with two modes: a 7-lane endless runner and a pixel-art side-scroller with three bullet-hell bosses.

What this proves

  • A game engine from scratch

    A custom game loop drawn on Canvas, no game framework.

  • A 2.5D camera

    One button flies the view into perspective; the rules stay 2D.

  • Tested game rules

    61 unit tests, including a bot that plays every level.

  • Art, music and levels

    Sprites, sounds, music and levels made by my own tools.

Role

Developer · Designer

Stack

Java · Android SDK · SurfaceView + Canvas · JUnit · Gradle · Python

Ki Runner cover
  • Classic Run in the 2.5D view: the pixel hero on a cloud in a perspective lane grid, a ki blast flying ahead toward a pink enemy block, and the LEFT, JUMP, SCORE, KI and RIGHT buttons below.
    Classic Run in 2.5D: dodge, jump or blast the falling blocks across seven lanes.
  • Adventure mode, stage 3 on Extreme: the hero on a cloud facing The Null King, a crowned hooded boss, with its health bar and the score at the top, over a pixel galaxy.
    A boss fight: The Null King, stage 3 of Adventure, on Extreme.
  • A POWER UP banner as the hero transforms into the white-haired Zenith form, with lightning around him and enemy blocks ahead.
    Ki from monsters and orbs powers the hero up through five forms.
2
Game modes
3
Boss fights
61
Unit tests

Problem

A college lab asked for a simple three-lane endless runner on Android. I wanted to see how far one person could take it: a real game with a camera, bosses, music and tests, still meeting every rule of the original brief.

Process

The game is plain Java on the Android SDK. Each mode runs its own loop on a background thread and draws every frame on a SurfaceView Canvas, with no game engine. The rules (movement, hitboxes, scoring, spacing between obstacle rows) live in plain Java classes, separate from the drawing, so JUnit can test them without a phone.

Classic Run widens the lab's runner to seven lanes with a jump and a ki blast. Adventure is a side-scroller across three stages, each ending in a bullet-hell boss fight: rain from above, walls with a gap, closing rings, warned beams and homing orbs, faster and denser once a boss is enraged. Easy, Hard and Extreme change hearts, bullet speed and the score multiplier.

The sprites, the space background, the sound effects, the music and the level layouts are all generated by my own Python scripts, so a level or a sprite is edited as code and rebuilt.

Key Decisions

  • Logic apart from drawing: the 2.5D camera only changes how things are drawn, never the rules, so hitboxes and scoring are identical in both views.
  • A bot plays the levels: a test runs through every Adventure level to prove each one can be finished.
  • Fair input on every device: keyboard, touch, swipes and the Android emulator (which never sends a key release) are all decoded into the same moves, with tests that replay measured key timings.
  • Auto-pause and resume: leaving the app pauses the game, and a 3-2-1 countdown brings it back.

Outcome

Ki Runner ships as an Android app with both modes, three difficulties, three bosses and two original music tracks. It meets every requirement of the original lab and goes well past it, and the source is public on GitHub.