spellbot 2.4.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. Keep in mind that sometimes SpellBot will respond to you via Direct Message to avoid being too spammy in text channels.

• !help: Provides detailed help about all of the following commands.
• !about: Get information about SpellBot and its creators.

✋ Queueing

• !play: Get in line to play some Magic: The Gathering!
• !leave: Get out of line; it's the opposite of !play.
• !status: Show some details about the queues on your server.

👑 Administration

• !spellbot: Admin subcommands to configure SpellBot for your server.

Subcommands:

• config: Just show the current configuration for this server.
• channels: Set the channels SpellBot is allowed to operate within.
• prefix: Set the command prefix for SpellBot in text channels.
• scope: Set the matchmaking scope to server-wide or channel-specific.
• expire: Set how many minutes before games are expired due to inactivity.

🙌 Support Me

I'm keeping SpellBot running using my own money but if you like the bot and want to help me out, please consider donating to my Ko-fi.

❤️ 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.

🔧 Running SpellBot Yourself

First install spellbot using pip:

pip install spellbot

Provide your Discord bot token with the environment variable SPELLBOT_TOKEN. As well as your SpellTable API authorization token via SPELLTABLE_AUTH. You can get your bot token from Discord. As for the SpellTable API authorization token, you'll have to talk to the SpellTable developers. You can join their Discord server by becoming a SpellTable patron.

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.

---

MIT © amy@lexicalunit et al