Trivia/Bot Setup

Let your viewers play trivia in chat with bot commands.

Trivia runs through your existing chat bot (StreamElements, Nightbot, or Streamlabs). You add one custom command that points to our API — we handle questions, scoring, and session management. No new bot to install or authorize.

Loading settings...

Bot command

StreamElements chat
!cmd add !quiz $(urlfetch https://laughingwhales.com/api/trivia/command?action=$(1)&extra=$(2)&channel=$(channel)&level=$(user.level)&user=$(user.name))
  1. 1.Make sure the StreamElements bot is active in your channel
  2. 2.Open your Twitch chat
  3. 3.Copy the command below and paste it into chat
  4. 4.StreamElements will confirm the command was added
  5. 5.Run !quiz in chat — you'll see a message to approve the source below

Loading sources...

Trivia Commands

Available once the bot command is installed.

SyntaxDescriptionPermission
!quiz a [1-4]

Reveal the answer (after cooldown), or vote on a multiple-choice question

No args = reveal the answer. Honors the per-channel cooldown (see cooldown=<N>) so chat can't skip past a question instantly. With a number 1–4, registers your vote when the active question is multiple-choice; the reveal then includes a tally.

Everyone
!quiz v <1-4>

Vote on the active multiple-choice question

Required: a number 1–4 selecting one of the displayed choices. Each viewer's vote is per-question and idempotent — repeating with a different number overwrites the previous vote.

Everyone
!quiz games

List available game packs

No args. Lists every installed pack with its slug.

Everyone
!quiz help [command]

Show available commands

Options: no arg = summary of every command; <command> = detail for one command (e.g. !quiz help q).

Everyone
!quiz skip

Skip current question

No args. Mods only.

Mod
!quiz reset

Clear question history

No args. Mods only. Wipes the used-question set so the channel can replay questions they've already seen.

Mod
!quiz q [game=slug|category=slug|<slug>]

Ask a trivia question

Options: no arg = next question from the active pack; game=<slug> = switch packs for this question; category=<slug> (alias cat=<slug>) = narrow to one category; <slug> = shorthand for game=<slug>.

Everyone
!quiz categories [game=slug]

List categories for current game

Options: no arg = categories for the active pack; game=<slug> = categories for a specific pack (accepts <author:slug> for community packs).

Everyone
!quiz challenge

Spin the killer + challenge wheel

No args. Returns a share URL with a fresh random seed.

Everyone
!quiz survivor [players] [challenges]

4-player survivor challenge wheel

Options: no arg = 4 players × 1 challenge each; [players] = 1–4 players; [challenges] = 1–4 challenges per player. Example: !quiz survivor 2 3 → 2 players, 3 challenges each.

Everyone
!quiz game=<slug>

Switch game pack for the current session

Required: <slug> from !quiz games. Mods only. Applies to the current session (resets after ~4 hours of inactivity). For a persistent default, use pack=<author:slug> with a community pack.

Mod
!quiz cooldown=<N>

Set answer cooldown for the current session

Required: <N> = seconds between 0 and 300. Mods only. 0 disables the cooldown; values over 300 are rejected. Applies to the current session (resets after ~4 hours of inactivity).

Mod
!quiz pack=<author:slug>

Switch to a public community game pack (persists)

Required: <author:slug> — a published community pack reference. Mods only. Persists as the channel's default pack across sessions. Use pack=clear to revert to the built-in packs.

Mod