ataxexe / engage-game

A game for Red Hat Summit 2017.

Engage

A Customer Portal game for Red Hat Summit 2017 in Boston.

Basic setup

npm install
npm start

Leap motion setup

The game can be played with a mouse, but for extra fun, set up a Leap motion device as follows.

1. Go to https://www.leapmotion.com/setup/desktop/linux and follow the instructions there (unpack box, plug in Leap, download driver)
2. The Leap driver is packaged for Ubuntu/Debian. We use Fedora, so they must be converted to rpms, like so:
   1. Install alien: sudo dnf install alien
   2. Extract the Leap_Motion_Setup_Linux_x.x.x.tgz file
   3. cd into the extracted directory
   4. cd into the Leap_Motion_Installer_Packages_release_public_linux directory
   5. Convert debs to rpms: sudo alien -rv --scripts Leap-*x64.deb
   6. Install rpms: sudo rpm -ivh --nodeps --force leap*.rpm
3. Start the leap driver: sudo leapd
4. Once the Leap is plugged in and the driver is installed, try launching the Leap visualizer to verify it's working. To do that, run Visualizer
5. Spend a few minutes playing with the Visualizer :)
6. Now that the Leap is working, you can start Engage normally. It will automatically connect to the Leap. (Note: the mouse still works even when the Leap is active)

Development commands

After running npm start, BrowserSync will automatically reload your browser when files change. No more manual refreshing! You can open the game in multiple browsers and they will all be refreshed together. Clicks will also be synchronized so you can test the game in several browsers at the same time.

If you also want to test the leaderboard server, run this in another terminal:

npm run leader-server-test

NOTE! The above will not persist

If you want to run the game in prod with a persistant leaderboard server you'll first need to install and run mongodb:

dnf install mongodb mongodb-server mongo-tools
systemctl start mongod
systemctl enable mongod

Once mongodb is installed and running you can run the prod leaderboard parse server with:

npm run leader-server-prod

This will persiste leaderboard data across retarts.

To enable sending notifications to top score bumps, you mus have a engage-server-running and the client configured to point to it. Example:

ENGAGE_SERVER_URL: 'http://localhost:8000'

Get the engage game server here: https://github.com/redhataccess/engage-game-server

Configuration

There are a ton of configuration options in src/js/config.js most of them are well documented in the code.

If the game seems to hard to avoid the Shellshock you can turn the values of these to settings:

// Vuln difficulty.  Tune these to make shellshocks easier to avoid
VULN_ACCEL: 1200,
VULN_TRACKING: 0.016,