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 meant to be public and used by anyone for fun. Users with "Manage Messages" & "Manage Roles" permissions, hereafter called "Elevated Users", will also have access to extra settings that will make them able to set trivia quiz games up for use by other users (typical use cases include events, giveaways, etc.).

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).

Depending on the "type" of user running the command(s), some limitations apply to the usage of the trivia module. The following table shows such limitations.

User Type	MQ	MT	RR	TC	AD	SE
Normal (non-"Elevated")	10	3 minutes	No	No	No	No
Elevated	20	6 hours	Yes*	Yes**	Yes	Yes
Elevated (Premium)	30	7 days	Yes*	Yes**	Yes	Yes

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, now grouped under /trivia template. As an alternative way of starting a trivia (other than creating a new one with default settings), users can save a trivia template and load it at a later time. Trivia templates will be assigned with a new set of IDs ("template IDs") and will not directly be linked to their original trivia game configuration.

Note

Premium: As shown in the table, premium-enabled servers will have an increased cap of 30 questions and can set an interval for timed trivia games up to 1 week (see Premium Perks).

Additionally, /trivia template and /trivia export are only available within Premium-enabled servers.

Note

Every /trivia subcommand that takes a game or template (pick from autocomplete) requires it - only /trivia show defaults to the running/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

User: None - open to everyone by default (see the Permissions System)

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 instead - there's no slash equivalent for those.

At the time of writing this documentation page, the categories available from the Open Trivia Database are:

Animals
Art
Celebrities
Entertainment: Board Games
Entertainment: Books
Entertainment: Cartoon & Animations
Entertainment: Comics
Entertainment: Film
Entertainment: Japanese Anime & Manga
Entertainment: Music
Entertainment: Musicals & Theatres
Entertainment: Television
Entertainment: Video Games
General Knowledge
Geography
History
Mythology
Politics
Science & Nature
Science: Computers
Science: Gadgets
Science: Mathematics
Sports
Vehicles

The categories selection supports partial names: if you want to select "Mythology" you can just use "myth", etc.

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

User: None - open to everyone by default (see the Permissions System)

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

User: None - open to everyone by default (see the Permissions System)

Examples

/trivia start game:12

Answering a Trivia Question

Note

Answering a trivia question is done with in-message buttons instead of a text command.

/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

User: None - open to everyone by default (see the Permissions System)

Examples

/trivia results game:12

/trivia myresults

Command Syntax

/trivia myresults game:{pick from the list}

Command Description

Shows a detailed list of questions and the corresponding submitted answers for the user running this command, showing whether the given answers are correct or not.

This command only works on completed trivia games.

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

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 will show the info of the running (or paused) trivia game in the current channel, if any.

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

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

User: None - open to everyone by default (see the Permissions System)

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. Pausing a trivia will make users unable to submit answers for that trivia. If the trivia game was set as timed, the timer for the current question will continue to count down to zero, but the next question will not appear until the game is unpaused.

/trivia resume resumes a previously paused trivia, making users able to 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.

Stops (if paused) and deletes a trivia game from the server, also hiding 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 Premium-enabled servers.

This command only works on completed trivia games.

Exports the detailed info about a completed trivia into a .csv file, sent via DM. The file will contain the complete list of users who answered the trivia game and the corresponding correctness (or incorrectness) for each question in the trivia.

This is the only way of having a full list of users. The top 5 users are shown in the trivia final results embed.

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 Premium-enabled servers.

Saves the current configuration for the selected trivia into a "template" which can then be re-used with /trivia template load. Each run of this command will generate a new template ID.

Once saved, a template becomes independent from the corresponding original trivia game: changing the settings for the originating trivia game will not update the corresponding 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 Premium-enabled servers.

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

The new trivia game will be set in a "Initialized" status, and can be immediately started with /trivia start or further configured on the dashboard's Trivia page.

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

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 Premium-enabled servers.

Deletes a previously saved configuration template (it will not delete the originating trivia game).

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 Premium-enabled servers.

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

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

Examples

/trivia template show template:3

/trivia template list

Command Syntax

/trivia template list

Command Description

This command is only available in Premium-enabled servers.

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

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

Examples

/trivia template list

Managing trivia on the dashboard

Your server's Trivia page lists every trivia game (/trivia list's dashboard equivalent). Clicking a game whose status is Initialized opens a full settings form - this is where the role restriction, target channel, and auto-deletion settings that /trivia create's form doesn't cover live:

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

Premium-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.