MechaHamster {#mechahamster_readme}

MechaHamster is a game about guiding a futuristic hamster ball through dangerous space mazes, create mazes of their own, and share them with friends. Can you guide Major Hammy D. Hamster to safety?

Motivation

MechaHamster serves as a demonstration, sample, and reference for integrating Firebase with the Firebase Unity SDK, and Daydream with the Google VR SDK for Unity into a game project.

Overview

MechaHamster demonstrates the following concepts:

Mobile and Daydream play modes.
Firebase Analytics to measure various aspects of user behavior.
Firebase Authentication to associate user generated content with users.
Firebase Realtime Database to store map and user data in addition to sharing content.
Firebase Cloud Messaging to allow game admins to send push notifications which inform users of new map content.
Firebase App Invites to share user generated content with other players.
Firebase Remote Config to allow game admins to run experiments on game data without redeploying a new build of the game.
Firebase Test Lab to allow developers to test their game across a wide variety of hardware and device configurations at once.

Downloading

MechaHamster source code can be downloaded from Github.

Building

Open the project in at least Unity 5.6 beta, this is required for the Google VR SDK for Unity.
Download the Firebase Unity SDK and unzip.
Import the following plugins - using Assets > Import Package > Custom Package menu item - from the Firebase Unity SDK:
- FirebaseAnalytics.unitypackage
- FirebaseAuth.unitypackage
- FirebaseDatabase.unitypackage
- FirebaseInvites.unitypackage
- FirebaseMessaging.unitypackage
- FirebaseRemoteConfig.unitypackage
Select a target platform (iOS or Android) using the File > Build Settings menu option.
Add Firebase to your app using either the Firebase Unity SDK iOS Setup or Firebase Unity SDK Android Setup. For more information see Building MechaHamster.
Wait for the spinner (compiling) icon to stop in the bottom right corner of the Unity status bar.
Finally, select the File > Build Settings menu option then click Build and Run.

Documentation