base-blitz

An Augmented Reality (AR) game for Android built on Unity Engine for the CS6334 Virtual Reality course.

Overview of the repository

• BaseBlitz-Preliminary contains a preliminary version of the project.
• BaseBlitz-Final contains the final prototype version of the project with an implementation of Unity AI.
• APKs contains the Android Application Packages (APKs) for the Preliminary and Final prototypes
• Source.md contains links to assets used in the project and resources we referred to implement this project.
• Updates.md contains changes we made in Final prototype version on the basis of feedback that we received for the Preliminary prototype.

Collaborators

• Ojal Bhatnagar
• Ashish Pratap
• Sphoorti Kulkarni
• Prayas Patnaik

AR Foundation, AR Core (Android) and AR Kit

Our project uses the AR Foundation, AR Core (Android) and AR Kit packages for providing Augmented Reality functionality.

You can download the packages from the Unity Package Manager using the following steps:

1. In Unity Editor, go to Windows > Package Manager.
2. Select Packages: Unity registry option from the dropdown.
3. Search for AR in the search box.
4. Install AR Foundation.
5. Install ARCore XR Plugin for Android and ARKit XR Plugin for iOS.

Note:

• Make sure the version numbers for AR Foundation, ARCore XR Plugin and ARKit XR Plugin are same.
• ARKit requires XCode installed on your system.

Scenes

1. StartMenu - The game starts with StartMenu scene. This scene contains the 4 buttons - Play, Settings, Help, Quit. The Play button loads the next scene - ARExample. The Settings button allows the user to choose the difficulty level. There are 3 levels in the game- easy, medium and hard. Eaach difficulty level has a different time limit to complete the game. The Help button provides the user with basic instructions and details about collectibles. The Quit button exits the application.

2. ARExample - The scene contains the UI elemets for the user to track and play the game. There is a health bar, progress bar, shoot button, ammunition counter, sheild boost button, reticle pointer (cross-hair). To start the game the user has to scan QR scode of the AR marker to load the enemy base. The ammunition and boosts will be available to collect and the timer will begin once the base loads. The user will be able to shoot at objects such as anti-aircraft guns, bunkers, radar, and vehices on the ground. The anti- aircraft guns will be shooting at the player and affecting the player's health. The play can replenish health and ammunition by collecting therespective boosts available throught the game. The user wins the game if they desroy most of the object. The user loses the game if the health becomes zero or the timer runs out.

3. GameWon - If the user wins, this scene loads. The scene loads the StartMenu scene after 6 seconds or the user can click on the Home button to be redirected.

4. GameOver - If the user loses, this scene loads. The scene loads the StartMenu scene after 6 seconds or the user can click on the Home button to be redirected.

Interaction Techniques

User will use their phone to scan an AR Marker (QR Code). We have attached a copy of QR code image with this project. Lay the AR Marker on a flat surface, start the game and scan the code to anchor the military base to the ground.

• Move the phone around to navigate in the game world.
• There are 2 on-screen buttons: Shoot and Shield (represented by a Shield icon). Shield grants temporary invincibility for few seconds.
• To collect the collectibles, just take your phone near them.

Demo Video

https://youtu.be/1uR7S-nKAyU

QR code (AR Marker) is in qr-code.png.