ASOIAF TMG Discord Bot 🐉

Description

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.

Updating the Bot

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 master branch
• 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

Installation

Follow this link to add the bot to your server:

https://discord.com/api/oauth2/authorize?client_id=1011134218786574416&permissions=3072&scope=bot

Usage

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

Issues

To report issues (out of date or missing cards, typos, or any other bugs), please go to the Issues tab and click "New issue".

Development

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 !d for 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.

Updating Images

• 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.

Credits

• 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

Legal

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.