Skip to content

A Mobile Web Implementation of Johann Sebastian Joust

Notifications You must be signed in to change notification settings

bladechapman/Joust

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Mobile Web Interpretation of Johann Sebastian Joust

I Just Wanna Play!

Sure thing!

What is Joust?

Joust is a mobile web game designed to get you and your friends moving! The goal is to be the last player standing. When the music is slow, your controller (phone) is very sensitive to movement. Try to jostle your opponents' controllers to eliminate them, but be careful! If you move too quickly yourself, you're out of the game! When the music speeds up, you're allowed a small window to dash towards your opponents to eliminate them.

How Do I Play?

  1. With your mobile device, navigate to the address where your game server is being hosted.
  2. Un-mute your device and crank up the volume!
  3. Press "Create Room", or type a room code and press "Join Room"
  4. To ready up, press and hold the large square containing your character. Keep holding while the game has started or else you'll be eliminated!
  5. Once everybody is ready, play Joust!

Setup

To set up your own Joust server, clone this repository and run:

$ pip3 install -r requirements.txt

To start your Joust server, run

$ python3 server.py

Troubleshooting

The Server

Joust's server utilizes Flask and Flask-SocketIO for python3. Make sure all the proper dependencies are installed and that you have python3 installed.

The Client

Joust is only playable on motion-enabled devices. The client utilizes the DeviceMotionEvent API. Because this API is still experimental, it has some quirks that may cause issues with your particular device. See the documentation for more compatibility details.

To do

  • Make server more scalable by adopting WSGI-nginx architecture
  • Clean up the client code so functions are less exposed
  • Integrate front-end build process, and accommodate ES6, LESS, and minification.

About

A Mobile Web Implementation of Johann Sebastian Joust

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published