ShiinaScripts / TwiviaBot

TwiviaBot

A trivia game bot for your Twitch chat. To get started, visit TwiviaBot's channel and use the %join command in its chat.

Commands:

%join - Makes TwiviaBot join your channel.

• Only works in TwiviaBot's Channel.
• Ensure you /mod TwiviaBot in your channel so the bot will function properly.

%part - Makes TwiviaBot leave your channel.

• Only works in TwiviaBot's Channel.
• Does not remove points, leaderboard, or cooldown settings.

%trivia - Starts a trivia game in the channel.

• A trivia game may be started by any channel member.
• Answers to trivia questions must be above a 90% match to be counted as correct.
• Answers to trivia questions above an 80% match will be announced as 'close'.

%points - Displays the total points of a user in the current channel.

• Points are tracked separately in different Twitch channels.

%leaderboard - Displays the top 5 users with the most points in the current channel.

• Points are tracked separeately in different Twitch channels, so leaderboards will also be independent.

%skip - Skips the current trivia game question.

• Only the channel owner or a moderator of the channel may skip a question.
• Does not reset the cooldown set for the channel.

%cooldown - Displays/Modifies the amount of time before a new trivia game may be started.

• To modify a channel's cooldown, use the command %cooldown [time] where [time] is a number of seconds. ex: %cooldown 300 (5 minute cooldown)
• Only the channel owner or a moderator of the channel may modify the channel cooldown. For all other users, the command will display the total and remaining cooldown for the trivia game.

%category - Displays/Modifies the trivia question categories for the channel.

• To modify a channel's categories, use the command %category [category].
• To select more than one category, separate each category with a commma and NO SPACES. ex: %category anime,general,videogames
• To return to all categories, set the categories to 'all'. ex: %category all.
• Only the channel owner or a moderator of the channel may modify the channel categories. For all other users, the command will display the channel's selected categories.

%categories - Displays a list of all selectable categories.

• Available categories: ALL, GENERAL, BOOKS, FILMS, MUSIC, THEATRE, TV, VIDEOGAMES, BOARDGAMES, SCIENCE/NATURE, COMPUTERS, MATHEMATICS, MYTHOLOGY, SPORTS, GEOGRAPHY, HISTORY, POLITICS, ART, CELEBRITIES, ANIMALS, VEHICLES, COMICS, GADGETS, ANIME, ANIMATION.

Resources:

Bot made using TwitchIO.

Trivia question database.

To run bot.py you will need the following environment variables:

TMI_TOKEN=oauth:pjwk******************
CLIENT_ID=lgs0w*******************
BOT_NICK=TwiviaBot 

You can get your own token, client ID, and bot with a new (or your own) twitch account.