This is a Discord bot that will display images for most cards in the game A Song of Ice and Fire: The Tabletop Miniatures Game.
Unfortunately I'm no longer playing ASOIAF TMG, but I'm still happy to help the community keep it up to date.
If you'd like to add new cards, please follow these steps:
- Fork this repository
- Make your changes to your fork -- it's just editing data in
src\asoiaf - Create a pull request to merge your changes into this repository's
masterbranch - Attach a link to a zip file with your updated images -- I'll upload these to the S3 server that hosts the other images
- I'll review and merge your changes pretty quickly, within a day or two at most
- Once I merge your changes to
master, the bot will automatically update itself and restart within a few minutes
Follow this link to add the bot to your server:
https://discord.com/api/oauth2/authorize?client_id=1011134218786574416&permissions=3072&scope=bot
First, add the bot to your server uses the step(s) above.
Then, just type the following command in any public chat:
!asoiaf [card name]
Example: !asoiaf Lyanna Mormont
You can also use !a as a shorthand.
Example: !a Lyanna Mormont
You can also search by card type: !asoiaf [search parameter] t:[card type]
Available card types:
t:commander(shorthand:t:cm, t:c)t:combatunit(shorthand:t:cu)t:attachment(shorthand:t:a)t:noncombatunit(shorthand:t:ncu,t:nc,t:n)t:opponentattachment(shorthand:t:oa,t:o)t:tacticscard(shorthand:t:tactics,t:tactic,t:tc,t:t)t:tacticszone(shorthand: t:tz)t:informationcard(shorthand: t:info, t:i)t:gamemode(shorthand: t:gm)t:mission(shorthand: t:m)t:objective(shorthand: t:ob)t:terrain(shorthand: t:tr)
Example: !a Eddard t:a for all attachments that include "Eddard" in their name
You can also just ask for the front or back of a card:
!a [search parameter] -front or !a [search parameter] -f
!a [search parameter] -back or !a [search parameter] -b
You can also request every tactics card along with the commander.
!a [search parameter] -all
!a jaime -all will bring up Jaime's commander card and all of his tactics cards
To report issues (out of date or missing cards, typos, or any other bugs), please go to the Issues tab and click "New issue".
If I get hit by a bus or something, you can take over this project by:
- Forking it into your own repository
- Creating your own bot on Discord via https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot
- Go to the OAuth2 section, General, create a random redirect url (it's required but not used anywhere)
- Go to URL Generator, check "Bot", then check "Read Messages/View Channels" and "Send Messages"
- Click Copy to copy the URL and use it to add the bot to your server
- For running locally, clone .env.sample as .env and set the value of DISCORD_TOKEN to your Discord token (double-quotes around it) -- note that you use
!dfor local commands instead of!a. - For running on the cloud, just ensure DISCORD_TOKEN is set to your bot's token in your cloud provider's environment variables
- Even non-coders can update the data pretty easily -- it's in the src/asoiaf folder and broken up logically by faction and card type.
- If you update an existing image URL with a new file, also update IMAGE_CACHE_SUFFIX to be the date of the change to ensure the cache is cleared.
- Eric Lang, Michael Shinall, and the rest of the CMON team for a beautiful design
- Discord's API for allowing me to build a bot
- ASOIAFBuilder and On The Table Gaming for art and game data
- My local game group at The Realm, Games and Comics in Brea, California, for their feedback
This bot is 100% unofficial and is not supported by or affiliated with CMON Games.
A Song of Ice and Fire: Tabletop Miniatures Game logo, CMON, and CMON logo are registered trademarks of CMON Global Limited.