说明： VR游戏的配套网络应用程序（使用Unity制作），可根据游戏中发生的事情进行实时更新 (Companion web app for VR game (made with Unity) that features real-time updates based on what happens in-game)
Equilibrium is a first person virtual reality adventure game with real-time database connection and a companion web app. Our Firebase connection is integrated with a MySQL database and Sequelize, an object relational mapper for MySQL. The functionality of the web app works closely with encrypted C# data.
## Getting Started
### How to Play the Game:
- Live link to Linux (***-bit and 32-bit compatible): https://www.dropbox.com/s/xlbz6arn80uynjf/Linux%28***%2632%29.zip?dl=1
- Live link to Windows (***-bit and 32-bit compatible): https://www.dropbox.com/s/kmpiiteu02jaqq9/Windows%28***%2632%29.zip?dl=1
- MacOSX Build in early alpha, .dmg file currently not available.
- Android Build in early beta, requires Crossplatform D-Pad control integration but functional.
- VR Build, requires Gear VR compatible Android devices, and also requires headset (2016 Edition and above recommended): https://www.dropbox.com/s/5zwek3mrghj8k8u/Equilibrium_Beta7.apk?dl=1
- WASD-Standard controls for Windows/Mac/Linux platforms and press E for interacting with objects. Tab for toggling inventory view.
- VR Only: Look down at a 30-degree angle to move forward. Look up at a 30-degree angle to stop movement. Operate controls with either Samsung Gear VR’s headset control-pad, ‘tap’, to interact with object. Press bluetooth controller to pick up item.
### Prerequisities for Game:
#### For Windows/Mac OS X/Linux (Minimum Requirements)
- OS: Windows 7 and higher (*** bit only) / Mac OS X 10.5 / Ubuntu Linux, version 10.10 or later
- Processor: AMD Phenom II X2 550, 3.1GHz | Intel Pentium G4400, 3.30GHz
- Memory: 1 GB RAM
- Graphics: Integrated Graphics Card
- DirectX: Version 9+
- Network: Local
- Additional Notes: For Windows 7, service pack 1 is required
#### VR (Minimum Requirements)
- Samsung Gear VR
- All requirements that come with Gear VR (Compatible Devices Only)
### How to Use the Web App:
- Live link to companion web app: https://equilibrium-game.herokuapp.com/
- The web app has many dynamic features that add to the gameplay experience such as a history log of all items picked up, a WebGL map of the in-game environment, an achievements module, and a wiki of all possible items. It's also got more experimental (in-progress) features such as a slot minigame and a virtual store. Please check it out and give us feedback in the guestbook!
### Prerequisities for Web App:
#### Dependencies
- bcrypt-nodejs
- body-parser
- cookie-parser
- express
- express-handlebars
- express-session
- firebase
- firebase-admin
- gravatar
- method-override
- morgan
- mysql
- nodemon
- passport
- passport-local
- sequelize
- sequelize-cli
## Screenshots
### Low Polycount Version (Game):
### HD Version (Game):
### Map of Game Environment (Web App):
### Achievements (Web App):
## Technologies Used
### Core Game:
- Unity
- C#
- Android (SDK)
- Oculus (SDK)
- Samsung Gear VR
- AR
### Databases:
- MySQL
- Sequelize
- Firebase (SDK)
### Web App:
- HTML5/CSS3
- JavaScript
- jQuery
- Bootstrap
- Node.js
- Express
- Handblebars
- Three.js
- Collada
## Code Walkthroughs
### Model-View-Controller:
Separating our code into modules made our code much more readable and easy to work with. Although there is some initial investment in planning, the payoff of isolating chunks of code was significant as we can identify errors and, often times, re-use code almost effortlessly.
```
router.get('/',
itemController.checkItemsList,
minigameController.checkMinigame,
wikiController.checkWiki,
achievementController.checkAchievements,
storeItemController.checkStoreItems
);
```
### Game Real-Time Firebase Updates:
For the preliminary building stage of our game, we wanted to make sure we could get information from the game to Firebase in real-time or close to it. Getting Firebase SDK to update with organized data objects took a lot of tinkering, and eventually we scrapped .Push() method for Firebase, which was our initial method to get information from the game. Thanks to the Transaction class and list used to create objects in unique nodes, we were able to organize big chunks of relevent data that auto-sorts based on the time the data was created (when an interaction happens in game with a GameObject).
```
TransactionResult InventoryUpdate(MutableData mutableData) {
List