jouva/joustmania

Open Source JS Joust on a Raspberry Pi!

JS Joust for the Pi!

• JoustMania is a collection of playstation move enabled party games specifically designed for the raspberry pi
• Johann Sebastian Joust Started the movement game phenomenon, This collection of games attempts to expand upon the basic joust gameplay with new modes, as well as entirely new games.

Awesome Features!!

• 16+ Players simultaneous support! yup you heard that right, massive Joust battles
• Super easy setup
• Multi game support, go beyond the standard Joust game, with team battles, werewolf, zombies, and commander mode
• custom music support, play with your own music
• convention mode, no manual instructions needed, the game plays itself and switches between game modes.

Hardware

You will need the following to run PI party:

0. A raspberry pi 3 B
1. Micro SD card for the raspberry pi
2. Up to 3, Class 1, Bluetooth 4.0 usb adapters (each adapter can handle 6-7 move controllers)
3. External USB sound card
4. External battery (the larger the better)
5. Speaker, preferably portable
6. As many playstation move controllers as you can handle

Installation

0. Download and Install Raspbian on the micro SD card (tested with Jessie 2016-09-23 release)
1. Connect your bluetooth adapters, external USB Soundcard, ethernet, keyboard, mouse and hdmi output
2. Power up the Pi
3. Open a Terminal located at the top of the desktop (the black monitor icon), run these commands, and you're done!!

git clone https://github.com/adangert/JoustMania.git
cd JoustMania
sudo ./setup.sh

Pairing controllers

• once you have installed PiParty, in order to pair controllers, plug them into the raspberry pi via usb
• after a controller has been synced via usb, press the playstation sync button (the circular one in the middle) to connect the controller to the pi
• This process should only need to be done once, after this the controller should be permenently paired with the pi and will only need to be turned on via the sync button for any future games
• All the controllers may restart when pairing, this is expected, just keep plugging in new ones until they are all paired. if you encounter problems restart the pi, and continue pairing the remaining controllers, again once this process is finished you should not have to connect the controllers to the pi again via usb.

How to select a game mode

• In order to change between games, on any controller press the select button (located on the left side)
• The colors of the controllers show which game is selected, for example, for FFA, all controllers will be white
• Press start (located on the right side) on any controller to launch the selected game, a countdown until the game starts will begin!
• in order to remove a controller from play press all four front buttons (currently does not work with random mode)

Custom Music

• Joust mania comes with a single classical music piece
• play your own music, by copying it into the respective folders: /audio/(Joust, Zombie, Commander)/music/
• wav files currently supported.

Joust

• Based off of the original JS Joust
• The aim of the game is to force all the other players to move their controllers too fast, either by hitting the controller, making them flinch, or anything else you can think of
• The sensitivity of the controllers is tied to the music, when the music speeds up, you are able to move faster
• If your controller is going too fast it will flicker and vibrate as a warning.
• If you are knocked out, your controller goes dark and vibrates.
• The last player standing has their controller flash a beautiful rainbow sequence, and all controllers vibrate to indicate the end of the game.

FFA (all controllers are white)

• The most basic version of Joust, Be the last one standing!

Teams (all controllers are solid colors)

• This game is the same as Joust FFA however at the beginning players select their team color with the big button in the middle of their controller
• There are six teams to select from

Random Teams (all controllers changing colors)

• Same as Joust Teams, however the teams are randomly assigned at start of play
• There are three teams in this mode

WereJoust (one controller red, the rest white)

• Same as Joust Teams, although there is one hidden "Werewolf" on one of the teams
• When the countdown starts the werewolf will feel a vibration, letting that player know they are the Werewolf
• The Werewolf is on their own team, and will win only if they are the last player remaining
• There are two regular teams in this mode

Zombie apocalypse

• two players start out as zombies, and try to infect the humans
• humans can shoot random zombies with bullets
• bullets are randomly assigned as loot from killing zombies
• humans try to survive for a couple of minutes, otherwise zombies win!

Commander

• teams are split into two sides
• one commander is chosen for each side, if this commander dies, the other team wins
• commanders can activate special abilities that helps their team win.

Random mode (for conventions)

• all players press the A button(middle of controller) to signal they are ready to play
• once all players are in a random game mode (excluding commander) will be selected
• instructions for the game mode will play and the game will begin

Ninja (coming soon)

• players start on two teams
• when you die, you switch to the other team.