The Thopter codebase is no longer used or maintained by Scryfall. This project is archived for posterity, you should not use this code. Please check out our shiny new centralized bots instead
Slackbot to unfurl MTG cards from scryfall.com.
While referring to a Magic: the Gathering card on Slack, surround its name with
]]) and prepend with an optional token. Thopter will print
out a the text of that card, its image, or its prices:
||Show a text representation of Snapcaster Mage.|
||Show an picture of Sphinx's Revelation.|
||Show prices for printings of Force of Will (currently FPO data).|
Create a new custom integration of the 'Bot' type in your Slack. We recommend naming it "Thopter".
Get its API token and memorize it.
Clone the repository
git clone https://github.com/scryfall/thopter.git cd thopter
Install the Heroku CLI for your platform.
Set up your app on Heroku:
heroku login heroku create heroku ps:scale web=0:free heroku ps:scale worker=1:free heroku config:set SLACK_TOKEN=<the slack token you memorized above>
Push to Heroku:
git push heroku master
Invite the bot to any channels where you want it to participate.
Thopter will graphical symbols in a format that looks like
:mana-u:. To transform them to their visual equivalent, you can create custom emoji for your Slack organization for each symbol. These are all contained within the
manamoji directory of this repository, and should be given a Slack name corresponding to its file name (e.g. the file
mana-e.png should be named
:mana-e: in Slack):
To develop Thopter, the steps are similar, only you run the instance locally instead of from Heroku.
To set up a development environment:
npm install SLACK_TOKEN=<the slack token you memorized above> DEBUG=true npm start
- It's recommended that you have a separate test bot ("Servo" is a great name) and channel for testing.
- After making changes, you will need to restart the bot to see them reflected.