Skip to content

About

An open-source Android game featuring procedural level generation, dynamic difficulty scaling, and a custom physics loop.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

KOrunner 🏃‍♂️💨

KOrunner is a lightweight, custom-built endless runner game for Android, written entirely in Kotlin. It demonstrates how to create a performant 2D game using standard Android APIs without relying on heavy external game engines.

🎮 Overview

The player controls a duck that must jump over mushroom obstacles to survive. The game features a custom game loop, physics-based movement, and dynamic rendering using the Android Canvas and SurfaceView.

✨ Features

  • Three Difficulty Levels: Choose between Easy, Medium, and Hard modes to test your reflexes.
  • Custom Game Engine: Built from scratch using SurfaceView for optimized performance (60 FPS target).
  • Procedural Generation: Obstacles and clouds are generated algorithmically for endless replayability.
  • Physics System: Implements gravity, velocity, and collision detection.
  • Immersive Experience: Full-screen mode with hidden system UI.

🛠 Tech Stack

  • Language: Kotlin
  • UI/Rendering: Android SDK (SurfaceView, Canvas, Paint)
  • Architecture: Custom Game Loop
  • Minimum SDK: API 31

🚀 Getting Started

  1. Clone the repository:
    git clone https://github.com/Icey067/KOrunner-Android.git
  2. Open in Android Studio.
  3. Build and Run: Connect your Android device or start an emulator and run the app.

🕹 How to Play

  • Tap any button on the menu to navigate.
  • Tap the screen while playing to JUMP.
  • Avoid the mushrooms and survive as long as possible!

📜 License

This project is licensed under the Apache-2.0 License.

About

An open-source Android game featuring procedural level generation, dynamic difficulty scaling, and a custom physics loop.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages