CATCH is an intuitive and easily accessible mobile game that gets you hooked from the first minute. Control your sprite by touch, catch the good objects falling down and be rewarded, but by all means avoid the bad objects or you will be punished!

Outline

• 1 Getting Started
  • 1.1 Prerequesites
  • 1.2 Installing
• 2 Play Guide
• 3 Built With
• 4 Versioning
• 5 Authors
• 6 License

1 Getting Started

1.1 Prerequisites

• An Android device or emulator supporting Google Play Games Services with API version 24 or later versions
• Create a user in the Google Play Games app in order to play multiplayer
• In order to test the multiplayer game, you must be added as a tester on the Google Developer Console by one of the contributors of Catch
• In multiplayer mode, you need to be connected to the internet

1.2 Install, Compile and Run

• Download Android Studio on you computer

• Clone the project from terminal

  • cd your-git-directory
  • git clone https://github.com/maalfrid/Catch.git

• Open the project in Android Studio:
  

  

• Choose the cloned Catch directory:
  

  

• Press the Open button and wait for the Gradle build is finished:
  

  

• Run the project by pressing the green "play" button:
  

  

• Further instructions for running the app:

  • Go to this section if you have a device
  • Go to this section if you don't have a device

1.2.1 With Device

• Connect device to the computer with USB
• One the device: Enable permission to access the device from the computer
• Select your device appearing in "Connected Devices"
• Press OK to run the app on your device

1.2.2 With Emulator

Disclaimer: We do not recommend you to test the game with an emulator as the game is supposed to be played with touch when moving your avatar.

• Create a new device:
  

  

• Choose one of the devices with a play store symbol:
  

  

• Press next

• Choose a version of the Android mobile operating system having an API level 24 or later versions

  • Press the Download button for the chosen version

• Press next

• Press finish - Wait until the virtual device is installed

• Press OK:
  

  

2 Play Guide

2.1 Play Single player

• Press Play
• Choose Singleplayer
• Choose difficulty - Easy, Medium or Hard
• Move the player by touch!
  • Catch good objects and power-ups, but avoid bad objects
  • The scoring system is described here

2.2 Play Multiplayer

• In the landing page, press Play and further Multiplayer
• Sign in to your Google Play Games account
• Choose Quick game:
  • Wait until your opponent joines the quick game
  • When the opponent has joined, the game will start automatically
  • As in single player - Catch good objects and power-ups, but avoid bad objects. If you catch a power-up it will affect your opponent and and vice versa.
  • The scoring system is described here

2.3 Scoring system

There are good objects, bad objects and power-ups objects following down in the Catch game. A description of their scoring or behavior follows. A player loses the game if he/she has no lives left.

Good objects

5 points

3 points

2 points

1 point

Bad objects

-3 points

-2 points

Power-ups

The effect of a power-up is active from you catch it and in 10 seconds.

If you catch a...

• - Good objects are getting bigger, bad objects are getting smaller
• - You only get good falling objects
• - You get an extra life
• - You don't lose lives of missing good objects, and don't lose points of catching bad objects

If your opponent catches a...

• - Bad objects are getting bigger, good objects are getting smaller
• - You only get bad falling objects
• - You lose double score when catching bad objects

3 Built With

• Android Studio
• Google Play Games Services (for multiplayer)

4 Versioning

Build gradle version 3.3.2.

5 Authors

List of contributors who participated in this project.

6 License

This project is licensed under the MIT License - see the LICENSE.md file for details.