Skip to content

Latest commit

 

History

History
95 lines (76 loc) · 6.26 KB

README.md

File metadata and controls

95 lines (76 loc) · 6.26 KB
Raw

Oust

Also known as Candle Fight, Jonty Sebastian Joust, and "that game with the lights".

A love letter to Johann Sebastian Joust, designed for playing outdoors at noisy festivals in the dark. All night long (all night).

Rpi Oust Setup

A long time ago on a boat far far away

When organising Electromagnetic Wave in early 2013 we asked some of the Wild Rumpus organisers to run evening games on the boat. A very beta version of Joust was run on the deck to rave reviews.

Fast forward to 2015. We've taken Joust (in both beta and final versions) to OHM in 2013 and EMF in 2014. Every time the game runs all night with almost no supervision.

By this point the game has developed a bit of a following and people are actively seeking us out to play. But there are problems. Joust requires a laptop to run (meaning we need to be near a power supply and can't leave it alone), it needs speakers for the music (which we never have), and people have trouble understanding the gameplay without announcements and cues.

I went to CCC in 2015 prepared. We had 11 move controllers, three Raspberry Pi's, 46 Ah of portable batteries, and more bluetooth adapters than there are bluetooth channels.

Oust is the result. It runs on a Raspberry Pi 2/3, can run up to 8 controllers (maybe more), and is specifically designed for environments so loud sign language is required.

It was playtested and tweaked extensively at CCC - at one point with a circle of approximately 150 people playing & watching. The longest game I recorded finished after 9 hours of continuous play.

How to Oust

  1. Turn the Raspberry Pi on.
  2. Turn the controllers on.
  3. Play!

No really how does one Oust

The game is designed to run on a Raspberry Pi hooked up to a honking great battery pack. There is no interface other than the controllers themselves.

If you were starting out from scratch this is what it would look like:

  1. Install Oust on the Raspberry Pi, including the nasty bluetooth hacks (See below).
  2. Plug the Pi into your battery pack.
  3. Connect each controller to the Pi in turn using a MiniUSB cable. When the controller goes white it has been paired.
  4. Turn on as many controllers as you want to play with.
  5. Each player presses the trigger, and the game begins.
  6. Optionally put the Pi & battery in a plastic sandwich box.

But what does the game look like?

  1. All the controllers are dark. As the players press the squishy trigger their controller lights up white.
  2. When all the controllers are white (or someone presses Triangle) the controllers will vibrate, then flash red/yellow/green as a "get ready" signal.
  3. Every controller turns a different colour and the game has begun.
  4. 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 the other player doing something stupid.
  5. If your controller is going too fast it'll flicker as a warning.
  6. If you are knocked out, your controller goes dark and vibrates.
  7. The last player standing has their controller flash a beautiful rainbow sequence, and all controllers vibrate to indicate the end of the game.
  8. The game resets, people hand their controllers to other people to play. GOTO 1.

Amazing Features

  • Instant setup
  • Easy pairing
  • Add/remove controllers to the game on the fly
  • Battery checking button (Press circle)
  • Secret goddamn-it-start-the-game button (Press the START button)
  • Turn off controller button before game start (Press the SELECT button)
  • "Ready, Steady, Go" start sequence to get players attention
  • Going-too-fast warning
  • Support for as many controllers as bluetooth interference will allow

How to install Oust from an image

@hdsjulian has built a Raspbian image with Oust preinstalled and preconfigured, flash it in the same way you'd flash any other Raspberry Pi image: http://phinn.de/oustpi.img.zip (sha256sum: 7db3147ba2c7a2d8910a16c02eb7ed84424a5bdd39686bc30ea61b7820f99a8b)

How to install Oust Manually

  1. Get a Raspberry Pi 2
  2. Install Raspbian on the SD card
  3. Checkout PSMoveAPI to the pi user's home directory (https://github.com/thp/psmoveapi)
  4. Merge in this patch to fix compilation on the Rpi thp/psmoveapi#184
  5. apt-get install swig python-dev bluez
  6. Build PSMoveAPI standalone (5.b here https://github.com/thp/psmoveapi/blob/master/README.ubuntu)
  7. Copy oust.py to /home/pi/psmoveapi/build/
  8. apt-get install supervisor
  9. Replace /etc/supervisor with the contents of supervisor
  10. Copy scan_enable.sh to /home/pi/
  11. Reboot the pi and pair your controllers!

Things You Should Know

  • The Playstation Move controllers actually implement the USB 1.2 standard, which means they NEED a data connection to charge. Essentially, you must connect them to a computer to charge them, a wall wart won't do.
  • Building PSMoveAPI is horrid. I'll publish debian packages soon.
  • The Raspberry Pi has a number of problems. The main one is that the current kernel (or bluez) shipped in Raspbian is broken - as soon as one controller is paired and has an active data link, the bluetooth adapter receives a command telling it to disable connecting to any other devices. Fortunately I was camping with ms7821 and gavan who are terrifying bluetooth experts and spent a happy afternoon with HCI packet dumps debugging this. scan_enable.sh is the hilarious solution they came up with - once a second it pokes all the bluetooth devices and tells them to accept connections again.

Future Things I May Do

  • A pre-built bootable image for the Raspberry Pi (possibly USB bootable)
  • Debian packages of PSMoveAPI for the pi
  • A script that does all the install things
  • Better support for more than 8 controllers