How create a voting session

This site is designed to replicate the voting system used for real life games of Blood on the Clocktower for online play.

To set up a game you will need to create a new session for your players. You can do this by clicking the "Start a new session" button on the navigation bar above. This will create a new game with a default number of voters.

As the person who created the session you should see a white admin panel on the right of the page. This contains a number of controls to administer your vote.

Inviting Players

To invite players you have two options.

To invite a player to a specific seat, give them a copy of the "link to join" under the seat you want.
To invite players to take the first available seat copy the "Join" link at the top of the page.

Voting process:

Changing the First Voter will rotate the players around to set the person who will get to vote first (always the person at the top of the list). For example, if player 3 in a 5 player game has been nominated, you can set player 4 to be the First Voter (meaning player 3 will be the last).

You can then select how many seconds you would like each player to have to vote and then press the Start Vote button to initiate the vote process. This will show all players a countdown timer for each players time to vote in the seating order displayed.

Change number of Voters:

This will let you change the number of voters in your game. Simply update the number in the Number of Voters field, and press update to change your game size. This will update your session, and the session of all connected players.

Swap voters:

This function allows you to change the seats of your players. By selecting two voters to change places and then clicking the Swap button, you will change your players seating positions.

Once your game is setup to your liking you can invite players by sending them the links next to each position in the voting space. Players joining through these links will not see your admin controls, but will be invited to enter their players name and are given control of a voting chip. Help on how to use this can be found here.

Advanced Notes

The URL which players join through controls their position on the board, number of players in the game and the ID of the session they are in. You can edit this URL manually if you wish to play with these. The format is as follows:

/vote/index/A/B/C

Where:

A: Number of players (5-20)
B: Your position (0 for admin then 1-20 for players)
C: Session id (feel free to make one up if you like)

Feedback, Source code and questions

Code for this site can be found at my github here (its in the webserver branch at the moment).

Feedback is welcome, but this is a side project developed in between a full work schedule and a new baby, so don't expect much fast! (this might also explain any typos or issues you spot).