lexicalunit · lexicalunit · Sep 11, 2026 · Sep 11, 2026 · Sep 11, 2026 · Sep 11, 2026
diff --git a/COMMUNITY.md b/COMMUNITY.md
@@ -0,0 +1,64 @@
+# Community
+
+Where to play, and how to help.
+
+## 🔭 Where to Play?
+
+SpellBot helps Discord servers to build communities around playing Magic online. Please check out the following servers to find games and connect with other players. You can also see [live queues][queues] waiting for you to join!
+
+<div align="center">
+<!-- SERVERS BEGIN -->
+<table>
+    <tr>
+        <td align="center"><a href="https://www.patreon.com/tolariancommunitycollege"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/tolarian-community-college.png" alt="Tolarian Community College" /><br />Tolarian&nbsp;Community&nbsp;College</a></td>
+        <td align="center"><a href="https://discord.com/invite/cedh"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/cedh.png" alt="cEDH" /><br />cEDH</a></td>
+        <td align="center"><a href="https://discord.com/invite/9Z7x8dh6Tf"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/edh-fight-club.png" alt="EDH Fight Club" /><br />EDH&nbsp;Fight&nbsp;Club</a></td>
+    </tr>
+    <tr>
+        <td align="center"><a href="https://linktr.ee/cedhspain"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/comunidad-espanola-de-cedh.png" alt="Comunidad Española de cEDH" /><br />Comunidad&nbsp;Española&nbsp;de&nbsp;cEDH</a></td>
+        <td align="center"><a href="https://www.cedh.uk/"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/cedh-uk.png" alt="cEDH UK" /><br />cEDH&nbsp;UK</a></td>
+        <td align="center"><a href="https://www.playedh.com/"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/playedh.png" alt="PlayEDH" /><br />PlayEDH</a></td>
+    </tr>
+    <tr>
+        <td align="center"><a href="https://discord.gg/3jwqduTkGZ"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/champ-de-bataille.png" alt="Champ de Bataille" /><br />Champ&nbsp;de&nbsp;Bataille</a></td>
+        <td align="center"><a href="https://www.playtowinmtg.com/"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/play-to-win.png" alt="Play to Win" /><br />Play&nbsp;to&nbsp;Win</a></td>
+        <td align="center"><a href="https://discord.gg/commander"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/the-commander-staple.png" alt="The Commander Staple" /><br />The&nbsp;Commander&nbsp;Staple</a></td>
+    </tr>
+    <tr>
+        <td align="center"><a href="https://disboard.org/server/757455940009328670"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/oath-of-the-gaywatch.png" alt="Oath of the Gaywatch" /><br />Oath&nbsp;of&nbsp;the&nbsp;Gaywatch</a></td>
+        <td align="center"><a href="https://www.facebook.com/EDHTambayan/"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/edh-tambayan.png" alt="EDH Tambayan" /><br />EDH&nbsp;Tambayan</a></td>
+        <td align="center"><a href="https://linktr.ee/women_in_magic"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/women-in-magic.png" alt="Women+ In Magic" /><br />Women+&nbsp;In&nbsp;Magic</a></td>
+    </tr>
+    <tr>
+        <td align="center"><a href="https://www.convoke.games/"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/convoke.png" alt="Convoke" /><br />Convoke</a></td>
+        <td align="center"><a href="https://discord.com/invite/mtg-home-689674672240984067"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/mtg-at-home.png" alt="MTG@Home" /><br />MTG@Home</a></td>
+        <td align="center"><a href="https://discord.gg/CfCb9fmgCD"><img width="200" height="200" src="https://spellbot.io/assets/img/servers/top-tier-bangers.png" alt="Top Tier Bangers" /><br />Top&nbsp;Tier&nbsp;Bangers</a></td>
+    </tr>
+</table>
+<!-- SERVERS END -->
+</div>
+
+Want your community to be featured here as well? Please contact me at [spellbot@lexicalunit.com](mailto:spellbot@lexicalunit.com)!
+
+## 🎤 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](https://www.playedh.com/) 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 as _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.
+
+---
+
+[Getting Started](GETTING_STARTED.md) · [Features](FEATURES.md) · [Back to README](README.md)
+
+[discord-invite]: https://discord.gg/HuzTQYpYH4
+[follow]: https://bsky.app/profile/spellbot.io
+[issues]: https://github.com/lexicalunit/spellbot/issues
+[kofi]: https://ko-fi.com/lexicalunit
+[patreon]: https://www.patreon.com/lexicalunit
+[queues]: https://queues.spellbot.io
diff --git a/FEATURES.md b/FEATURES.md
@@ -0,0 +1,56 @@
+# Features
+
+What SpellBot does for your playgroup.
+
+## 🤝 Matchmaking
+
+`/lfg` posts a game other players can join, and SpellBot keeps track of the seats. When the game fills it creates the table on the service your server plays on — [Convoke][convoke], [Playgroup Live][playgroup], [EDHLAB][edhlab], [Girudo][girudo] or [Table Stream][tablestream] — and shares the link with everyone who joined.
+
+<p align="center">
+    <img
+        src="https://spellbot.io/assets/img/screenshots/lfg.png"
+        width="600"
+        alt="The embed SpellBot posts after running the /lfg command"
+    />
+</p>
+
+Games can be filtered by format and bracket, players can block others they'd rather not be matched with, and admins can set per-channel defaults. See [Administration](ADMINISTRATION.md) for the full list.
+
+## 📡 Live queues
+
+[Live queues][queues] shows every game forming across every SpellBot community at once. Log in with Discord to filter down to just the servers you play in, set up notifications so you're pinged when a game you care about is forming, and look back through your own game history and records.
+
+## 📊 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)!
+
+<p align="center">
+    <img
+        src="https://spellbot.io/assets/img/screenshots/mythic-track-setup.png"
+        width="617"
+        alt="Running the /setup_mythic_track command in Discord"
+    />
+</p>
+
+## 🎲 Playgroup Live
+
+SpellBot can also seat your games on [Playgroup Live](https://playgroup.gg/playgroup-live), creating a table for up to six players with starting life totals that match the format you queued for. One player in the game needs to connect their account first: run the `/playgroup link` command and SpellBot will find your Playgroup Live account and remember it for future games.
+
+## 🎥 Castlog
+
+SpellBot keeps a history of your games on [Castlog](https://castlog.gg/). When the result of a game is reported, SpellBot forwards the match on and Castlog builds a page for it, then links that page back to the game so you can find it later. Players who have connected their Castlog account are credited on the match automatically. Castlog's [SpellBot setup guide](https://castlog.gg/features/spellbot) walks through getting started.
+
+## 🔌 Adding a service
+
+Want SpellBot to support another play service? [Integrations](INTEGRATIONS.md) documents everything needed to add one.
+
+---
+
+[Getting Started](GETTING_STARTED.md) · [Community](COMMUNITY.md) · [Back to README](README.md)
+
+[convoke]: https://www.convoke.games/
+[edhlab]: https://edhlab.gg/
+[girudo]: https://www.girudo.com/
+[playgroup]: https://playgroup.gg/
+[queues]: https://queues.spellbot.io
+[tablestream]: https://table-stream.com/
diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
@@ -0,0 +1,54 @@
+# Getting Started
+
+Add SpellBot to your Discord server and run your first game.
+
+## 🤖 Add SpellBot to Discord
+
+SpellBot is free and works in any Discord server you manage. Adding it takes a minute and needs no configuration to get going.
+
+<div align="center">
+<a href="https://discord.com/api/oauth2/authorize?client_id=725510263251402832&permissions=2416045137&scope=applications.commands%20bot">
+<img
+        alt="Add to Discord"
+        src="https://spellbot.io/assets/img/screenshots/spellbot-banner.png"
+    />
+</a>
+</div>
+
+## 🃏 Run your first game
+
+Run `/lfg` in any channel and SpellBot posts a game other players can join. When the last seat fills, it creates the table on the service your server plays on and shares the link with everyone who joined.
+
+<p align="center">
+    <img
+        src="https://spellbot.io/assets/img/screenshots/lfg.png"
+        width="600"
+        alt="The embed SpellBot posts after running the /lfg command"
+    />
+</p>
+
+Once a game is forming you can watch it fill from [live queues][queues], where you can log in with Discord to browse games across every server, filter them down to just the communities you play in, set up notifications so you're pinged when a game you care about is forming, and look back through your own game history and records.
+
+## 📬 Let SpellBot message you
+
+The most common issue people have is not receiving Direct Messages from the bot. SpellBot uses Discord embeds in the DMs it sends, and there are a few settings you need to enable for that to work.
+
+1. In your Settings search for **embeds and link previews** and make sure that it's on.
+2. For each Server you will want to make sure that you have allowed Direct Messages from those server members. Search your Settings for **Direct Messages** and turn the option on.
+3. You may also need to enable message requests from server members you may not know. Search your Settings for **message requests** and turn that option on as well.
+
+## ⚙️ Configure your server
+
+Server admins can tune how SpellBot behaves per channel: which service games are created on, default seat counts, formats, motd, and more. See [Administration](ADMINISTRATION.md) for the full set of commands and settings.
+
+## 🛟 Still stuck?
+
+Join us on the [SpellBot Discord server][discord-invite] to get answers from our generous community. Wondering whether the bot is online? Check the [status page][status] for current health.
+
+---
+
+[Features](FEATURES.md) · [Community](COMMUNITY.md) · [Back to README](README.md)
+
+[discord-invite]: https://discord.gg/HuzTQYpYH4
+[queues]: https://queues.spellbot.io
+[status]: https://status.spellbot.io