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> If true, 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> If true, 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.

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 wins

    • avg Average score

    • total Total correct answers from all sessions

    • games 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 wins

    • avg Average score

    • total Total correct answers from all sessions

    • games 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.