AvadaKedavBot User Guide

AvadaKedavBot is a Wizarding World-inspired Twitch chat bot for Sorting Hat fun, house points, duels, magical flavor commands, and light channel management.

This guide covers the public commands and features available to viewers, moderators, and streamers. Random results such as quotes, wand details, Patronuses, and house flavor text are not fully listed here so they can remain fun to discover in chat.

Quick start

In any channel where AvadaKedavBot is active:

1. Type !sortme to be sorted into a house.
2. Type !house to check your saved house and current house points.
3. Type !points to view the House Cup standings.
4. Try flavor commands like !wand, !patronus, or !hpquote.
5. Challenge another viewer with !duel @username.
6. Use !resort for a new random house, or !resort Hufflepuff to choose a specific house.

Viewer commands

Sorting and houses

The Sorting Hat system assigns viewers to one of the four houses. Once sorted, your house is saved so AvadaKedavBot can remember it later.

Command	Description
!sortme	Sorts you into Gryffindor, Hufflepuff, Ravenclaw, or Slytherin.
!house	Shows your saved house, current house points, and a short house description.
!resort [house]	Re-sorts you into a new house. Without a house name, the new house is random. With a valid house name, you are placed into that house.
!points	Shows the current House Cup standings.
!gryffindor	Shows Gryffindor information and current points.
!hufflepuff	Shows Hufflepuff information and current points.
!ravenclaw	Shows Ravenclaw information and current points.
!slytherin	Shows Slytherin information and current points.

Using !resort replaces your saved house. You can let the Sorting Hat choose randomly with !resort, or choose a specific house with !resort Gryffindor, !resort Hufflepuff, !resort Ravenclaw, or !resort Slytherin.

Common short forms like gryff, huff, raven, and slyth are accepted.

Wizarding flavor

These commands add lightweight magical flavor to chat. Some results are saved, while others are randomized each time.

Command	Description
!wand	Gives you a saved random wand, or shows your existing wand.
!rewand	Replaces your saved wand with a new random wand.
!patronus	Shows a random Patronus.
!hpquote	Sends a random Wizarding World quote.

Using !rewand replaces your saved wand.

Dueling

Viewers can challenge each other to magical duels. Duel results are random, and winning may award house points if the winner has a saved house.

Command	Description
!duel @username	Challenges another viewer to a duel.
!accept	Accepts a pending duel challenge directed at you.
!decline	Declines a pending duel challenge directed at you.

A duel challenge must mention a target, such as !duel @username. The challenged viewer must respond with !accept or !decline before the duel expires.

Streamer commands

Channel management

Streamers can request AvadaKedavBot for their own channel from AvadaKedavBot’s own Twitch chat.

Command	Where to use it	Description
!join	AvadaKedavBot’s Twitch chat	Adds your channel to AvadaKedavBot’s joined-channel list.
!part	AvadaKedavBot’s Twitch chat	Removes your channel from AvadaKedavBot’s joined-channel list.

After using !join, AvadaKedavBot can begin responding in your channel. If you no longer want the bot in your channel, use !part from AvadaKedavBot’s own chat.

Channel safety

Channel safety commands give streamers a fast way to quiet or restore the bot in their own channel.

Command	Permission	Description
!muteakb	Channel owner	Silences AvadaKedavBot in that channel.
!unmuteakb	Channel owner	Restores AvadaKedavBot chat output in that channel.

These commands are useful if the bot is too noisy, unwanted during a specific stream segment, or needs to be paused quickly.

Cooldowns and limits

Some commands use short per-user cooldowns to prevent spam.

Command	Cooldown
!duel	5 seconds per user
!resort	5 seconds per user

Duel challenges also have a timeout window. If the challenged viewer does not respond with !accept or !decline in time, the challenge expires.

What AvadaKedavBot remembers

AvadaKedavBot saves some information so features can continue working across chat sessions.

Saved information may include:

• joined channels
• user houses
• user wands
• house point totals
• bot settings

This allows viewers to keep the same house and wand between visits unless they choose to change them.

Shared chat behavior

AvadaKedavBot is designed to reduce accidental cross-channel spam in shared chat situations. When shared chat behavior is detected, the bot may temporarily quiet certain responses, timers, or reminders.

Troubleshooting

The bot does not answer

Try the following:

1. Use !test to check whether AvadaKedavBot responds.
2. Make sure AvadaKedavBot is active in the channel.
3. Check whether the command is typed correctly.
4. Wait a moment in case the command is on cooldown.
5. Ask the streamer or channel owner whether the bot is muted.
6. If you are the channel owner, use !unmuteakb.

I am not sorted

Use !sortme, then check your house with !house.

I want a different house

Use !resort to get a new random house, or include a house name to choose one directly.

Examples: !resort Hufflepuff, !resort raven, or !resort slyth.

This replaces your saved house.

I want a different wand

Use !rewand. This replaces your saved wand.

My duel is not working

Make sure the command includes a target, such as !duel @username.

The challenged viewer must then use !accept or !decline before the challenge expires.

Privacy and data notes

AvadaKedavBot stores only the information needed for its public chat features, such as saved houses, saved wands, joined channels, and house point totals.

This public guide does not include deployment details, token details, private configuration, or internal database information.