- 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.



