Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lexicalunit/spellbot

The Discord bot for SpellTable.
https://github.com/lexicalunit/spellbot

discord-bot gaming lfg magic magic-the-gathering spelltable

Last synced: 20 days ago
JSON representation

The Discord bot for SpellTable.

Awesome Lists containing this project

README 

        
# SpellBot






spellbot









    Add to Discord






The Discord bot for SpellTable








|  |  |

| ---: | :---: |

| **Deployment**    | [![build][build-badge]][build] [![heroku][heroku-badge]][heroku] |

| **Dependencies**  | [![python][python-badge]][python] [![discord.py][discord-py-badge]][discord-py] |

| **Distribution**  | [![pypi][pypi-badge]][pypi] [![docker][docker-badge]][docker-hub] [![mit][mit-badge]][mit] |

| **Quality**       | [![codecov][codecov-badge]][codecov] [![ruff][ruff-badge]][ruff] [![pyright][pyright-badge]][pyright] |

| **Observability** | [![uptime][uptime-badge]][uptime] [![metrics][metrics-badge]][metrics] [![datadog][datadog-badge]][datadog] |

| **Socials**       | [![discord][discord-badge]][discord-invite] [![follow][follow-badge]][follow] |

| **Funding**       | [![patreon][patreon-button]][patreon] [![kofi][kofi-button]][kofi] |






## 🤖 Using SpellBot



SpellBot helps you find _Magic: The Gathering_ games on [SpellTable][spelltable] or [Table Stream][tablestream]. Just looking to

play a game of Commander? Run the command `/lfg` and SpellBot will help you out!





    /lfg




SpellBot uses [Discord slash commands][slash]. Each command provides its own help documentation that

you can view directly within Discord itself before running the command. Take a look and see what's

available by typing `/` and browsing the commands for SpellBot!



## 🔭 Where to Play?



These communities are using SpellBot to play Magic! Maybe one of them is right for you?






    

        PlayEDH
PlayEDH

        cEDH
cEDH

        Tolarian Community College
Tolarian Community College

    

    

        EDH Fight Club
EDH Fight Club

        Oath of the Gaywatch
Oath of the Gaywatch

        Top Tier Bangers
Top Tier Bangers

    

    

        EDH Tambayan
EDH Tambayan

        Play to Win
Play to Win

        Playing with Power
Playing with Power

    

    

        Comunidad Española de cEDH
Comunidad Española de cEDH

        The Commander Staple
The Commander Staple

        Command the Cause
Command the Cause

    

    

        ka0s Tournaments
ka0s Tournaments

        Turbo Commander
Turbo Commander

        cEDH UK
cEDH UK

    

    

        MTG@Home
MTG@Home

        Duel Commander
Duel Commander

        Proxy Pirates
Proxy Pirates

    






Want your community to be featured here as well? Please contact me at

[[email protected]](mailto:[email protected])!



## 📊 Mythic Track



SpellBot integrates seamlessly with [Mythic Track](https://www.mythictrack.com/spellbot) which allows you to track games within your Discord server. Visualize and explore your data to reveal interesting trends. To get started run the `/setup_mythic_track` command on your server. Please also consider [supporting Mythic Track](https://www.patreon.com/MythicTrack)!



    Mythic Track Setup




## ❓ Help



Two of the most common issues people using SpellBot run into are related to receiving Direct Messages from the bot. SpellBot uses Discord embeds in the DMs that it sends and there are some settings you need to enable for this to work correctly.



In your `Settings ► Chat` make sure that you have enabled **Embeds and link previews**.





    Settings - Chat




And in your `Settings ► Privacy & Safety`, enable both **Allow direct message message for server members** and **Enable message requests from server members you may not know**.





    Settings - Privacy & Safety




If you have more questions, please don't hesitate to join us on the [SpellBot Discord server][discord-invite] to get answers from our generous community.



## 🎤 Feedback



Thoughts and suggestions? Come join us on the [SpellBot Discord server][discord-invite]! Please

also feel free to [directly report any bugs][issues] that you encounter. Or reach out to me on

BlueSky at [@spellbot.io][follow].



## 🙌 Supported By



The continued operation of SpellBot is supported by PlayEDH as well as generous donations from [my patrons on Patreon][patreon] and [Ko-fi][kofi]. If you would like to help support SpellBot, please consider [signing up][patreon] for as little a _one dollar a month_ or [giving me a one-off tip][kofi] for whatever you feel is appropriate.



## ❤️ 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](CODE_OF_CONDUCT.md) and then see our

[documentation on how to contribute](CONTRIBUTING.md) for details on how to get started.



## 🐳 Docker Support



SpellBot can be run via docker. Our image is published to

[lexicalunit/spellbot][docker-hub]. See [our documentation on Docker Support](DOCKER.md) for help

with installing and using it.



## 🔍 Fine-print



Any usage of SpellBot implies that you accept the following policies.



- [Privacy Policy](PRIVACY_POLICY.md)

- [Terms of Service](TERMS_OF_SERVICE.md)



---



[MIT][mit] © [amy@lexicalunit][lexicalunit] et [al][contributors]



[build-badge]: https://github.com/lexicalunit/spellbot/workflows/build/badge.svg

[build]: https://github.com/lexicalunit/spellbot/actions

[codecov-badge]: https://codecov.io/gh/lexicalunit/spellbot/branch/main/graph/badge.svg

[codecov]: https://codecov.io/gh/lexicalunit/spellbot

[contributors]: https://github.com/lexicalunit/spellbot/graphs/contributors

[datadog-badge]: https://img.shields.io/badge/monitors-datadog-blueviolet.svg

[datadog]: https://app.datadoghq.com/apm/home

[discord-badge]: https://github.com/lexicalunit/spellbot/assets/1903876/871aca88-3636-4c38-bcc1-f4093f89146f

[discord-invite]: https://discord.gg/HuzTQYpYH4

[discord-py-badge]: https://img.shields.io/badge/discord.py-2.1.0-blue

[discord-py]: https://github.com/Rapptz/discord.py

[docker-badge]: https://img.shields.io/docker/pulls/lexicalunit/spellbot.svg

[docker-hub]: https://hub.docker.com/r/lexicalunit/spellbot

[follow-badge]: https://img.shields.io/badge/Bluesky-1185FE?style=flat&logo=bluesky&logoColor=white

[follow]: https://bsky.app/profile/spellbot.io

[heroku-badge]: https://img.shields.io/badge/cloud-heroku-green

[heroku]: https://dashboard.heroku.com/apps/lexicalunit-spellbot

[issues]: https://github.com/lexicalunit/spellbot/issues

[kofi-button]: https://img.shields.io/badge/Ko--fi-F16061?style=flat&logo=ko-fi&logoColor=white

[kofi]: https://ko-fi.com/lexicalunit

[lexicalunit]: http://github.com/lexicalunit

[metrics-badge]: https://img.shields.io/badge/metrics-grafana-orange.svg

[metrics]: https://lexicalunit.grafana.net/d/4TSUCbcMz/spellbot?orgId=1

[mit-badge]: https://img.shields.io/badge/License-MIT-yellow.svg

[mit]: https://opensource.org/license/mit

[patreon-button]: https://img.shields.io/badge/Patreon-F96854?style=flat&logo=patreon&logoColor=white

[patreon]: https://www.patreon.com/lexicalunit

[pypi-badge]: https://img.shields.io/pypi/v/spellbot

[pypi]: https://pypi.org/project/spellbot/

[pyright-badge]: https://img.shields.io/badge/types-pyright-c3c38f.svg

[pyright]: https://github.com/microsoft/pyright

[python-badge]: https://img.shields.io/badge/python-3.12-blue.svg

[python]: https://www.python.org/

[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json

[ruff]: https://github.com/astral-sh/ruff

[slash]: https://discord.com/blog/slash-commands-are-here

[spelltable]: https://spelltable.wizards.com/

[tablestream]: https://table-stream.com/

[uptime-badge]: https://img.shields.io/uptimerobot/ratio/m785764282-c51c742e56a87d802968efcc

[uptime]: https://uptimerobot.com/dashboard#785764282