Skip to main content

Search GiselleBot's commands and docs.

Try /ban, or start with / for commands only.

Press Ctrl K anywhere in the dashboard to open this.

Trivia

This module lets users play trivia quiz games on Discord. The module gets its default questions from the Open Trivia Database, which offers more than 3,000 validated questions in more than 15 categories.

The trivia module is public and open to anyone. Users with "Manage Messages" & "Manage Roles" permissions, called "Elevated Users" from here on, also get extra settings that let them set up trivia quiz games for other users (typical uses include events and giveaways).

Trivia games can be timed or immediate.

  • Immediate trivia games move to the next question as soon as one answer is collected.
  • Timed trivia games move to the next question as soon as a certain time interval passes, and collect answers from anyone during that period (limitations may apply, see later).

Limits depend on the type of user running the command(s).

User TypeMQMTRRTCADSE
Normal (non-"Elevated")103 minutesNoNoNoNo
Elevated206 hoursYes*Yes**YesYes
Elevated (Base or Power)307 daysYes*Yes**YesYes
  • MQ: Maximum # of Questions
  • MT: Maximum Time Interval
  • RR: Can set role restrictions
  • TC: Can set a different target channel
  • AD: Can configure auto-deletion of messages
  • SE: Can configure and/or start someone else's trivia

*: Users are not allowed to set a role restriction to roles higher than the highest role they have.

**: Users are not allowed to set a target channel to a channel they don't have R/W access to (Read Messages and/or Send Messages).

The module also includes a set of "template" commands, grouped under /trivia template. Instead of creating a new trivia with default settings, users can save a trivia template and load it later. Trivia templates get their own IDs ("template IDs") and are not directly linked to the configuration of the original trivia game.

Note

Premium: As the table shows, Base and Power servers both get an increased cap of 30 questions per game (up from 20) and can set an interval between questions of up to 1 week (up from 6 hours) for timed trivia games (see Premium Perks). The interval is the wait between one question and the next; it does not limit the total length of a game.

Both raised caps apply to Elevated users only, meaning users who hold both Manage Messages and Manage Roles in the server. A user without both stays at 10 questions and a 3-minute interval even on a Premium server.

/trivia export and the /trivia template command family require Power; Base does not unlock them.

Note

Every /trivia subcommand that takes a game or template (pick from autocomplete) requires it; only /trivia show defaults to the running or paused game in the current channel when omitted.

/trivia categories

Command Syntax

/trivia categories

Command Description

Shows all available trivia category names and the corresponding number of available questions.

Permissions Needed

Examples

/trivia categories

/trivia create

Command Syntax

/trivia create

Command Description

Opens a form to create a new trivia game in the current server.

The form asks for (all optional):

  • Name: shows in the title of each embed related to that trivia. Up to 128 characters.
  • Description: appears on each question, and in the starting and final embed. Up to 1024 characters.
  • Categories: comma-separated; leave blank for "any category". See the categories list below.
  • Interval: how long a question stays up in a timed trivia, e.g. 3h. Leave blank for an immediate trivia.
  • Number of questions: how many questions the game asks before it ends. Refer to the limitations table at the top of this page. A trivia game will always end early if fewer questions are actually available than the "configured" amount.

Note

/trivia create's form only covers the fields above. The role restriction, target channel, and auto-deletion settings are set from the server's Trivia page on the dashboard; there is no slash equivalent for those.

The Open Trivia Database currently offers these categories:

  1. Animals
  2. Art
  3. Celebrities
  4. Entertainment: Board Games
  5. Entertainment: Books
  6. Entertainment: Cartoon & Animations
  7. Entertainment: Comics
  8. Entertainment: Film
  9. Entertainment: Japanese Anime & Manga
  10. Entertainment: Music
  11. Entertainment: Musicals & Theatres
  12. Entertainment: Television
  13. Entertainment: Video Games
  14. General Knowledge
  15. Geography
  16. History
  17. Mythology
  18. Politics
  19. Science & Nature
  20. Science: Computers
  21. Science: Gadgets
  22. Science: Mathematics
  23. Sports
  24. Vehicles

The category selection accepts partial names, so "myth" selects "Mythology".

Note

There will soon be a way to add custom categories and custom questions to the database.

Note

There can only be 1 running (or paused) trivia game per channel at a given time.

Permissions Needed

Examples

/trivia create

/trivia start

Command Syntax

/trivia start game:{pick from the list}

Command Description

Starts a trivia game in its configured target channel, using the corresponding settings. Start typing in game to pick it from an autocomplete list.

Note

There can only be 1 running (or paused) trivia game per channel at a given time.

Permissions Needed

Examples

/trivia start game:12

Answering a Trivia Question

Note

Answering a trivia question uses in-message buttons; there is no text command for it.

/trivia results

Command Syntax

/trivia results game:{pick from the list}

Command Description

Prints the final results of a trivia game. This is the same embed that is printed when a trivia game ends, showing the top 5 users and their corresponding scores.

This command only works on completed trivia games.

Permissions Needed

Examples

/trivia results game:12

/trivia myresults

Command Syntax

/trivia myresults game:{pick from the list}

Command Description

Shows each question, the answer submitted by the user running the command, and whether that answer is correct.

This command only works on completed trivia games.

Permissions Needed

Examples

/trivia myresults game:12

/trivia show

Command Syntax

/trivia show [game:{pick from the list}]

Command Description

Shows the current configuration of a trivia, given its ID.

If game is omitted, the command shows the info of the running (or paused) trivia game in the current channel, if any.

Permissions Needed

Examples

/trivia show
/trivia show game:12

/trivia list

Command Syntax

/trivia list

Command Description

Shows the list of all (non-deleted) trivia games in the server: their ID, name and status.

Permissions Needed

Examples

/trivia list

/trivia pause / /trivia resume

Command Syntax

/trivia pause game:{pick from the list}
/trivia resume game:{pick from the list}

Command Description

These commands are only available to Elevated Users.

/trivia pause pauses a trivia, which prevents users from submitting answers for it. If the trivia game was set as timed, the timer for the current question keeps counting down to zero, but the next question does not appear until the game is unpaused.

/trivia resume resumes a previously paused trivia and lets users submit answers again.

Permissions Needed

  • User: Manage Messages, Manage Roles

Examples

/trivia pause game:12
/trivia resume game:12

/trivia delete

Command Syntax

/trivia delete game:{pick from the list}

Command Description

This command is only available to Elevated Users.

This command only works on paused or completed trivia games.

Deletes a trivia game from the server (stopping it first if it is paused) and removes its ID from /trivia list.

Permissions Needed

  • User: Manage Messages, Manage Roles

Examples

/trivia delete game:12

/trivia export

Command Syntax

/trivia export game:{pick from the list}

Command Description

This command is only available to Elevated Users in Power-enabled servers.

This command only works on completed trivia games.

Exports a completed trivia as a .csv file, sent via DM. The file lists every user who answered the trivia game and whether each answer was correct.

This is the only way to get a full list of users; the final results embed shows only the top 5.

Permissions Needed

  • User: Manage Messages, Manage Roles

Examples

/trivia export game:12

/trivia template save

Command Syntax

/trivia template save game:{pick from the list}

Command Description

This command is only available to Elevated Users in Power-enabled servers.

Saves the current configuration of the selected trivia as a "template", which can then be re-used with /trivia template load. Each run of this command generates a new template ID.

Once saved, a template is independent of the trivia game it came from: changing the original game's settings does not update the template.

Permissions Needed

  • User: Manage Messages, Manage Roles

Examples

/trivia template save game:12

/trivia template load

Command Syntax

/trivia template load template:{pick from the list}

Command Description

This command is only available in Power-enabled servers.

Loads a previously saved configuration from a template, creating a new trivia game with a new trivia ID.

The new trivia game starts in an "Initialized" status. It can be started right away with /trivia start or configured further on the dashboard's Trivia page.

Permissions Needed

Examples

/trivia template load template:3

/trivia template delete

Command Syntax

/trivia template delete template:{pick from the list}

Command Description

This command is only available to Elevated Users in Power-enabled servers.

Deletes a previously saved configuration template. The trivia game it came from is not deleted.

Permissions Needed

  • User: Manage Messages, Manage Roles

Examples

/trivia template delete template:3

/trivia template show

Command Syntax

/trivia template show template:{pick from the list}

Command Description

This command is only available in Power-enabled servers.

Shows the current configuration of a trivia template, given its ID.

Permissions Needed

Examples

/trivia template show template:3

/trivia template list

Command Syntax

/trivia template list

Command Description

This command is only available in Power-enabled servers.

Shows the list of all (non-deleted) trivia templates in the server: their ID, name and basic info.

Permissions Needed

Examples

/trivia template list

Managing trivia on the dashboard

Your server's Trivia page lists every trivia game, the dashboard equivalent of /trivia list. Clicking a game with Initialized status opens a full settings form with the role restriction, target channel, and auto-deletion settings that /trivia create's form does not cover:

  • Channel: the target channel the game will run in.
  • Who May Answer: a multi-role restriction (leave empty to allow everyone); this is the role restriction mentioned above.
  • Categories: the same category picker as /trivia create's form.
  • Timing: a "Use a Fixed Interval (Timed Trivia)" toggle plus an interval input, or immediate mode when off.
  • Number of Questions: leave blank to use the default.
  • Randomize Question Order, Auto-Delete Answers, and Auto-Delete Confirmation Messages: independent toggles.

A game that is no longer Initialized (Running, Paused, Completed, etc.) shows this same form read-only instead.

Note

Power-enabled servers also get a Templates page under Trivia, mirroring /trivia template save/load/delete: pick an existing game to snapshot as a template, load a template into a brand-new game, preview a template's saved settings inline, or delete it.

See also

Full migration mapping for these commands: Migration Guide.