Trivia
This is the cog guide for the trivia cog. You will find detailed docs about usage and commands.
[p]
is considered as your prefix.
Note
To use this cog, load it by typing this:
[p]load trivia
Usage
This cog allows for playing trivia with others. You may choose to play just one category at a time or choose multiple to add variety to your game. You can even create your own lists!
Commands
Here is a list of all of the commands for this cog:
triviaset
Note
This command is locked to the mod role.
Syntax
[p]triviaset
Description
Commands for managing trivia settings.
triviaset botplays
Note
This command is locked to the mod role.
Syntax
[p]triviaset botplays <true_or_false>
Description
Sets whether the bot gains a point if nobody guesses correctly.
Arguments
<true_or_false>
Iftrue
, the bot will gain a point if nobody guesses correctly, otherwise it will not.
triviaset maxscore
Note
This command is locked to the mod role.
Syntax
[p]triviaset maxscore <score>
Description
Sets the total points required to win.
Arguments
<score>
The amount of points required to win.
triviaset override
Note
This command is locked to the mod role.
Syntax
[p]triviaset override <enabled>
Description
Allow/disallow trivia lists to override the settings.
Arguments
<enabled>
Whether trivia lists should be able to override settings.
triviaset payout
Note
This command is locked to the mod role.
Syntax
[p]triviaset payout <multiplier>
Description
Sets the payout multiplier.
If a user wins trivia when at least 3 users are playing, they will receive credits; the amount received is determined by multiplying their total score by this multiplier.
Arguments
<multiplier>
The amount to multiply the winner’s score by to determine payout. This can be any positive decimal number. Setting this to 0 will disable.
triviaset revealanswer
Note
This command is locked to the mod role.
Syntax
[p]triviaset revealanswer <true_or_false>
Description
Sets whether or not the answer is revealed if the time limit for answering runs out.
Arguments
<true_or_false>
Iftrue
, the bot will reveal the answer if there is no correct guess within the time limit.
triviaset showsettings
Note
This command is locked to the mod role.
Syntax
[p]triviaset showsettings
Description
Shows the current trivia settings.
triviaset stopafter
Note
This command is locked to the mod role.
Syntax
[p]triviaset stopafter <seconds>
Description
Sets how long the bot should wait before stopping the trivia session due to lack of response.
Arguments
<seconds>
The number of seconds to wait before stopping the session.
triviaset timelimit
Note
This command is locked to the mod role.
Syntax
[p]triviaset timelimit <seconds>
Description
Sets the maximum time permitted to answer a question.
Arguments
<seconds>
The number of seconds to wait for an answer.
triviaset custom
Note
This command is locked to the bot owner.
Syntax
[p]triviaset custom
Description
Manage custom trivia lists.
Tip
Looking to learn how to create your own trivia lists? See here for more information.
triviaset custom upload
Note
This command is locked to the bot owner.
Syntax
[p]triviaset custom upload
Description
Upload a custom trivia list. The bot will prompt you to upload your list as an attachment in Discord.
triviaset custom list
Note
This command is locked to the bot owner.
Syntax
[p]triviaset custom list
Description
List all uploaded custom trivia lists.
triviaset custom delete
Note
This command is locked to the bot owner.
Syntax
[p]triviaset custom delete <name>
Description
Delete a custom trivia list.
Arguments
<name>
The name of the custom list to be deleted.
trivia
Syntax
[p]trivia <categories...>
Description
Start a trivia session on the specified category.
Multiple categories can be listed, in which case the trivia session will use all of the specified lists to select questions from.
Arguments
<categories...>
The category to play. Can be multiple.
trivia leaderboard
Syntax
[p]trivia leaderboard
Description
Shows the trivia leaderboard. Defaults to the top ten in the current server, sorted by total wins. The subcommands provide more customized leaderboards.
trivia leaderboard global
Syntax
[p]trivia leaderboard global [sort_by=wins] [top=10]
Description
The global trivia leaderboard.
Arguments
[sort_by=wins]
The method by which to sort the leaderboard (defaults to wins). Can be one of:wins
Total winsavg
Average scoretotal
Total correct answers from all sessionsgames
Total games played.
[top=10]
The number of ranks to show on the leaderboard. Defaults to 10
trivia leaderboard server
Syntax
[p]trivia leaderboard server [sort_by=wins] [top=10]
Description
The trivia leaderboard for this server.
Arguments
[sort_by=wins]
The method by which to sort the leaderboard (defaults to wins). Can be one of:wins
Total winsavg
Average scoretotal
Total correct answers from all sessionsgames
Total games played.
[top=10]
The number of ranks to show on the leaderboard. Defaults to 10
trivia list
Syntax
[p]trivia list
Description
Lists the available trivia categories
trivia stop
Syntax
[p]trivia stop
Description
Stops an ongoing trivia session.