Balance IT - Space (Re-master)

This code repository is on active development. The gameplay stage is completed and the game is playable.

This project is a refactored code release of my Android game Balance IT - Space. I made this game back in 2012, and that version is still available in the Google Play Store. It's an Android accelerometer sensor game that works well even on modern phones. The following video showcases this game.

Having looked at my decade-old code written before my bachelor's, I decided that a public release requires a major code refactoring. This code repository is a re-implementation of that same game using a better-designed code base. So far, I have completed the implementation of the game-play stage and the game-over screen. The development of menus is future work. As before, everything is developed directly on top of the OpenGL ES library available with Android SDK using Java. I have developed a new game engine layer that implements low-level features, isolating the game code from the Android OpenGL ES platform.

The following screenshots are from the newly developed version.

The codebase consists of two sections:

1. The Game: Implements the gameplay scene, game over scene and the gameplay logic.
2. The Game Engine: Consists of core game engine which provides onUpdate and onRender calls. The graphics package wraps OpenGL ES 2.0 library using a 3D graphics engine and a sprite engine. Multi-scene package allow swapping between scenes (E.g. gameplay scene, game over scene). The UI package implements common UI elements such as Label, ImageButton, Image etc.

How to compile the code?

1. Setup gradle wrapper 6.5.

gradle wrapper --gradle-version 6.5

2. Run ./gradlew build. The apk file will be generated at app/build/outputs/apk directory.

Alternatively, you can open the project directory using Android Studio after completing the step 1.

Tests

We use Android Instrumentation Tests.

1. Connect a device that can be used to run instrumentation tests.
2. Run ./gradlew connectedAndroidTest to run Android Instrumentation Tests.