spellbot 1.0.0

A Discord bot for SpellTable

SpellBot

A Discord bot for SpellTable.

📱 Using SpellBot

Once you've connected the bot to your server, you can interact with it over Discord via the following commands in any of the authorized channels.

• !help: Provides detailed help about all of the following commands.
• !about: Get information about SpellBot and its creators.
• !hello: Gives you some good tidings.
• !queue: Get in line to play some Magic: The Gathering!
• !leave: Get out of line; it's the opposite of !queue.

WIP: Commands

Status

As a DM to the bot:

!status

• Gives you some information on your place in the queue
• Possibly give you some status on your history of games and win/lose

Reporting

In a text channel:

!report win @username[, @username, @username, ...]
!report draw @username[, @username, @username, ...]

• Automatically know what game based on the last game in which that user was a member of
• Indicates that @username is the winner of their match
• Potentially there could be multiple winners or draws
• Allow for mistakes, user's should be able to run report multiple times
• At some point after the first report, reporting needs be finalized
• Do we need a !report loss command for any reason?

Moderation

As a DM to the bot by an authorized user:

!ban @username <reason> [minutes]

• Block the user from being able to use the bot (optionally for the given minutes)

!unban @username

• Remove user from the block list

!bans

• Show the list of bans and reasons

!ops @username

• Authorize someone else to be able to moderate

!unops @username

• Remove someone from moderation

!admin @username

• Authorize someone to be able to administrate

!unadmin @username

• Remove someone from administrators

!report ... ?

• Potentially have mods/admins be able to go in and manually change reports if need be

Concerns / Thoughts / Ideas

• After a game is created, it needs to expire at some point
• After a report is done, how long until the report command stops working
• Does a user's game need to be reported before they can re-queue?
• What happens if a game is never reported on?
• When matchmaking w/ power levels, does it need to be a 100% match, +/- how much?
• What about using ELO to match make?

🤖 Running SpellBot

First install spellbot using pip:

pip install spellbot

Provide your Discord bot token with the environment variable SPELLBOT_TOKEN.

By default SpellBot will use sqlite3 as its database. You can however choose to use another database by providing a SQLAlchemy Connection URL. This can be done via the --database-url command line option or the environment variable SPELLBOT_DB_URL. Note that, at the time of this writing, SpellBot is only tested against sqlite3 and PostgreSQL.

More usage help can be found by running spellbot --help.

🐳 Docker Support

You can also run SpellBot via docker. See our documentation on Docker Support for help.

❤️ Contributing

If you'd like to become a part of the SpellBot development community please first know that we have a documented code of conduct and then see our documentation on how to contribute for details on how to get started.

---

MIT © amy@lexicalunit et al