Commands: Polls (!vote)

Overview

When a poll is opened, the bot will list the poll's question and choices in chat.


Example:
[Splaturday] What do you want to play/watch for the Viewer's Choice hour?
[Splaturday] 1) Splatoon 1
[Splaturday] 2) Splatoon 2
[Splaturday] "!vote ", where  = 1, 2.

You are able to vote for a choice; each choice lists its reference (e.g. "2") and text (e.g. "Splatoon 2"). Since the text might be long, you may cast your vote using the reference for convenience.

Available to Everyone

!vote ["<poll reference>"] <choice>

Impersonation Allowed

Casts a vote for <choice>. Only your most-recent vote counts (allowing you to change your choice). You can specify the choice by reference (e.g. "2") or by text (e.g. "Splatoon 2"). In case multiple polls are open, you can optionally specify the poll reference (useful if multiple polls have choices that are the same); you can cast a vote for only one poll per command.
Examples:
!vote 2
!vote Splatoon 2
!vote "Splaturday" Splatoon 2
!vote uncast [<poll reference>]

Impersonation Allowed

Removes your vote. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote uncast
!vote uncast Splaturday
!vote results [<poll reference>]
States how many votes each choice received. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote results
!vote results Splaturday

Available to Moderators

!vote list all
Lists all available polls.
Example:
!vote list all
!vote list current
Lists all currently-open polls.
Example:
!vote list current
!vote restate
Re-states the choices for all currently-open polls.
Example:
!vote restate
!vote won [<poll reference>]
States which choice(s) won (or are currently winning, in the case of an open poll). If there is a tie for winner, all choices with the most votes are included. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote won
!vote won Splaturday
!vote open <poll reference>
Opens the poll specified by <poll reference>, starting with no votes.
Example:
!vote open Splaturday
!vote reopen [<poll reference>]
Re-opens the poll specified by <poll reference>, retaining all existing votes. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote reopen
!vote reopen Splaturday
!vote unopen [<poll reference>]
Un-opens the poll specified by <poll reference>. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote unopen
!vote unopen Splaturday
!vote close [<poll reference>]
Closes the poll specified by <poll reference>. If no poll reference is specified, the most-recently-opened poll is assumed.
Examples:
!vote close
!vote close Splaturday